Consultar extrato

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}}'

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}}'

[
    {
        "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"
                }
            }
        }
    }
]

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

{
    "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."]
}

GET

baas

api

transactions

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}}'

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}}'

[
    {
        "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"
                }
            }
        }
    }
]

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

{
    "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."]
}

Para o passo a passo completo, veja o guia Extrato.

Headers

string

required

Sua API key.

string

required

Número da conta Delfinance.

Query params

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.

string

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

string

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

boolean

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

string

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

string

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

number

NSU da transação.

string

default:"desc"

Ordem por data: desc ou asc.

number

default:"1"

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

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

string

Identificador da transação na Delfinance.

string

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

number

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

number

Valor da transação, sempre positivo.

string

Descrição da transação.

string

Data e hora do lançamento, em UTC.

object

Tipo da transação.

Show propriedades

string

Código do tipo, como CREDIT_PIX ou DEBIT_TRANSFER_EXTERNAL.

string

Descrição do tipo em português.

boolean

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

object

Saldo da conta no momento do lançamento.

Show propriedades

number

Saldo antes do lançamento.

number

Saldo depois do lançamento.

object

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

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}}'

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}}'

[
    {
        "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"
                }
            }
        }
    }
]

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

{
    "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."]
}

Introdução

Pix

Boleto

Pagamento de contas

Split de Pagamentos

Conta

Webhooks

Headers

Query params

Response

​Headers

​Query params

​Response

Headers

Query params

Response