> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lazydata.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar itens

> Liste pastas e arquivos do armazenamento da conta.

Lista os itens de uma pasta do armazenamento, incluindo pastas, arquivos, breadcrumbs, resumo de uso e paginação.

Quando `parent_id` não é informado, a API lista a raiz do armazenamento.

<ResponseExample>
  ```json 200 theme={null}
  {
    "code": 200,
    "message": "Itens carregados.",
    "result": {
      "parent": null,
      "breadcrumbs": [
        {
          "id": null,
          "name": "Início"
        }
      ],
      "folders": [
        {
          "id": "54d8a266-4e21-4a9a-9c15-b4b93bc11c6e",
          "type": "folder",
          "name": "Contratos",
          "parent_id": null,
          "created_at": "2026-06-22T11:55:00+00:00",
          "updated_at": "2026-06-22T11:55:00+00:00"
        }
      ],
      "files": [
        {
          "id": "9fcb573b-7f62-4774-978b-07e89dfef5f2",
          "type": "file",
          "name": "contrato.pdf",
          "parent_id": null,
          "extension": "pdf",
          "content_type": "application/pdf",
          "size": 24576,
          "status": "uploaded",
          "uploaded_at": "2026-06-22T12:00:00+00:00",
          "created_at": "2026-06-22T11:59:40+00:00",
          "updated_at": "2026-06-22T12:00:00+00:00"
        }
      ],
      "summary": {
        "used_bytes": 24576,
        "quota_bytes": 1073741824,
        "available_bytes": 1073717248,
        "usage_percent": 0.01,
        "files": 1
      },
      "pagination": {
        "offset": 0,
        "limit": 50,
        "loaded": 2,
        "next_offset": 2,
        "total": 2,
        "folders_total": 1,
        "files_total": 1,
        "has_more": false
      }
    }
  }
  ```

  ```json 401 theme={null}
  {
    "code": 401,
    "message": "Credencial da API inválida."
  }
  ```

  ```json 403 theme={null}
  {
    "code": 403,
    "message": "A credencial da API não possui permissão para este recurso."
  }
  ```

  ```json 404 theme={null}
  {
    "code": 404,
    "message": "Pasta não localizada."
  }
  ```
</ResponseExample>

## Parâmetros

<ParamField query="parent_id" type="string">
  ID da pasta que será listada. Omitir para listar a raiz.
</ParamField>

<ParamField query="offset" default="0" type="integer">
  Posição inicial da listagem.
</ParamField>

<ParamField query="limit" default="50" type="integer">
  Quantidade máxima de itens retornados. O valor máximo é `100`.
</ParamField>

## Resposta

<ResponseField name="code" type="integer" required>
  Código da resposta da API.
</ResponseField>

<ResponseField name="message" type="string" required>
  Mensagem descritiva da resposta.
</ResponseField>

<ResponseField name="result" type="object" required>
  Objeto com pasta atual, breadcrumbs, pastas, arquivos, uso e paginação.
</ResponseField>

## Estrutura de `result`

| Campo         | Tipo            | Descrição                            |
| ------------- | --------------- | ------------------------------------ |
| `parent`      | `object/null`   | Pasta atual. Retorna `null` na raiz. |
| `breadcrumbs` | `array<object>` | Caminho da raiz até a pasta atual.   |
| `folders`     | `array<object>` | Pastas encontradas.                  |
| `files`       | `array<object>` | Arquivos encontrados.                |
| `summary`     | `object`        | Uso do armazenamento da conta.       |
| `pagination`  | `object`        | Dados de paginação.                  |

## Paginação

Quando `pagination.has_more` for `true`, repita a chamada usando `pagination.next_offset`.

```text theme={null}
GET /v1/storage/items
Query: parent_id=<pasta>&offset=50&limit=50
```