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

# Listar relatórios

> Liste os relatórios de extrato periódico gerados para a conta.

> [!NOTE]
>
> Para o passo a passo completo, veja o guia [Extrato periódico](https://docs.delfinance.com.br/guias/conta/extrato-periodico.md).

### Headers

**x-delbank-api-key** `string` *required*

Sua API key.

**x-delfinance-account-id** `string` *required*

Número da conta Delfinance.

### Query params

**page** `number` (default: 1)

Número da página (começa em 1).

**limit** `number` (default: 10)

Itens por página.

## Response

Array de relatórios. A paginação vem no header `Pagination` (`currentPage`, `pageSize`, `pageCount`, `rowCount`).

**id** `number`

Identificador do relatório. Use-o em [Consultar relatório](https://docs.delfinance.com.br/api-reference/conta/consultar-relatorio.md).

**description** `string`

Descrição do relatório, com a quantidade de transações.

**progress** `number`

Progresso da geração, de `0` a `100`.

**period** `object`

Período coberto pelo relatório, em UTC.

**propriedades**

**startDate** `string`

Início do período.

**endDate** `string`

Fim do período.

**status** `object`

Situação do relatório.

**propriedades**

**name** `string`

`FINISHED` quando o relatório está pronto para download.

**description** `string`

Descrição da situação.

**reportType** `object`

Tipo do relatório.

**propriedades**

**name** `string`

`BANKSTATEMENT`.

**description** `string`

Descrição do tipo.

```bash cURL theme={null}
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/customer-reports?page=1&limit=10' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'
```

```json 200 theme={null}
[
    {
        "id": 1058,
        "description": "Extrato com 35837 transações",
        "progress": 100,
        "period": {
            "startDate": "2026-10-27T03:00:00Z",
            "endDate": "2026-10-28T03:00:00Z"
        },
        "status": {
            "name": "FINISHED",
            "description": "Concluído"
        },
        "reportType": {
            "name": "BANKSTATEMENT",
            "description": "Extrato bancário"
        }
    }
]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.