Consultar extrato consolidado da conta.

POST

/accounts/consolidated-statement

Contas

Gera um resumo do extrato por dia ou por mês: entradas, saídas, resultado líquido e saldos inicial e final de cada período.

Informe groupBy (DAY ou MONTH) com initialDate e finalDate.

Regras do período:

MONTH: no máximo 12 meses; o mês final não pode ser posterior ao mês atual.

DAY: no máximo 60 dias; a data final deve ser anterior à data de hoje.

Requisição

Authorization

OAuth 2.0

Client Credentials

Adicionar o parâmetro

Authorization

a Cabeçalhos, cujo valor é concatenar o Token após o Bearer.

Exemplo:

Authorization: Bearer ********************

Token URL: /oauth/token

Scopes:

account.read-Permite consultar saldo e extratos da conta

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200

application/json

Resposta com os dados do extrato consolidado.

Bodyapplication/json

🟠400

🟠401

🟠403

🟠429

🔴500

🔴503

🔴504

Request Example

Shell

JavaScript

Java

Swift

cURL

Exemplo com agrupamento por DAYExemplo com agrupamento por MONTH

curl --location '/accounts/consolidated-statement' \
--header 'x-account-id;' \
--header 'Content-Type: application/json' \
--data '{
    "groupBy": "DAY",
    "initialDate": "2025-05-01",
    "finalDate": "2025-05-03"
}'

Response Example

200 - Exemplo de resposta com agrupamento por MONTH

{
    "data": [
        {
            "periodDate": "2025-01",
            "movementCount": 19,
            "creditAmount": 3678.45,
            "debitAmount": -1456.78,
            "diffAmount": 2221.67,
            "initialBalance": 2089.97,
            "finalBalance": 4311.64
        },
        {
            "periodDate": "2025-02",
            "movementCount": 49,
            "creditAmount": 0,
            "debitAmount": -1058.67,
            "diffAmount": -1058.67,
            "initialBalance": 4311.64,
            "finalBalance": 3252.97
        },
        {
            "periodDate": "2025-03",
            "movementCount": 7,
            "creditAmount": 1253.45,
            "debitAmount": -1000,
            "diffAmount": 253.45,
            "initialBalance": 3252.97,
            "finalBalance": 3506.42
        }
    ]
}

Página anterior

Consultar extrato consolidado por hora.

Próxima página

Listar chaves Pix da conta.