> ## 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.

# Consultar extrato

> Liste as transações da conta por período, tipo ou identificador.

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

### Headers

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

Sua API key.

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

Número da conta Delfinance.

### Query params

**startDate** `string`

Data inicial no formato `YYYY-MM-DD`, incluindo o próprio dia. Aceita até 6 meses atrás, contados a partir do primeiro dia do mês.

**endDate** `string`

Data final no formato `YYYY-MM-DD`, sem incluir o próprio dia.

**type** `string`

Tipo de transação, como `CREDIT_PIX`. Repita o parâmetro para filtrar por mais de um tipo.

**isCredit** `boolean`

`true` retorna só créditos. `false` retorna só débitos.

**endToEndId** `string`

`endToEndId` de um Pix. Retorna só essa transação. Considera os últimos 3 meses.

**id** `string`

Identificador da transação na Delfinance. Retorna só essa transação. Considera os últimos 3 meses.

**nsu** `number`

NSU da transação.

**orderByAscOrDesc** `string` (default: desc)

Ordem por data: `desc` ou `asc`.

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

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

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

Itens por página. Máximo: `50`. Valores acima são reduzidos para `50`.

## Response

Array de transações. A paginação vem no header `Pagination` (`currentPage`, `pageSize`, `pageCount`, `rowCount`, `totalAmount`).

**id** `string`

Identificador da transação na Delfinance.

**correlationId** `string`

Identificador enviado por você ao criar a operação, quando houver.

**nsu** `number`

Número sequencial único da transação na conta.

**amount** `number`

Valor da transação, sempre positivo.

**notes** `string`

Descrição da transação.

**createdAt** `string`

Data e hora do lançamento, em UTC.

**type** `object`

Tipo da transação.

**propriedades**

**name** `string`

Código do tipo, como `CREDIT_PIX` ou `DEBIT_TRANSFER_EXTERNAL`.

**description** `string`

Descrição do tipo em português.

**isCredit** `boolean`

`true` para entrada na conta, `false` para saída.

**balance** `object`

Saldo da conta no momento do lançamento.

**propriedades**

**balancePrevious** `number`

Saldo antes do lançamento.

**currentBalance** `number`

Saldo depois do lançamento.

**proof** `object`

Detalhes da operação. O formato muda conforme o tipo da transação.

```bash Por período theme={null}
curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/transactions?startDate=2026-10-01&endDate=2026-11-01&page=1&limit=50' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'
```

```bash Por endToEndId theme={null}
curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/transactions?endToEndId=E3822485720261027144231555972751' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'
```

```json 200 theme={null}
[
    {
        "id": "21E3822485720261027144231555972751",
        "correlationId": "1f9d63e8-81f6-4636-b862-e2edf4c72d67",
        "nsu": 727646,
        "amount": 5.00,
        "notes": "Pedido 1234",
        "createdAt": "2026-10-27T14:42:34.763Z",
        "type": {
            "name": "CREDIT_PIX",
            "description": "PIX recebido",
            "isCredit": true
        },
        "balance": {
            "balancePrevious": 15225.40,
            "currentBalance": 15230.40
        },
        "proof": {
            "endToEndId": "E3822485720261027144231555972751",
            "status": "PIX_EFFECTIVE",
            "type": "PIX_QR_CODE_DYNAMIC",
            "amount": 5.00,
            "description": "Pedido 1234",
            "payer": {
                "number": "31712",
                "branch": "0001",
                "type": "CURRENT",
                "holder": {
                    "document": "32752023000149",
                    "name": "EMPRESA PAGADORA LTDA",
                    "type": "LEGAL"
                },
                "participant": {
                    "name": "DELCRED SCD S.A.",
                    "ispb": "38224857"
                }
            },
            "beneficiary": {
                "number": "41820",
                "branch": "0001",
                "type": "CURRENT",
                "holder": {
                    "document": "11222333000181",
                    "name": "SUA EMPRESA LTDA",
                    "type": "LEGAL"
                },
                "participant": {
                    "name": "DELBANK",
                    "ispb": "38224857"
                }
            }
        }
    }
]
```

```json 400 theme={null}
{
    "errors": ["Não é possível consultar transações anteriores à 01/04/2026."]
}
```

```json 404 theme={null}
{
    "status": 404,
    "title": "Please refer to the errors property for additional details.",
    "code": "NOT_FOUND",
    "errors": ["Transação não encontrada. Essa consulta só considera transações a partir dos últimos 3 meses."]
}
```


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