Listar Transações

GET 
/v2/financial/accounts/:financial_account_uid/statement_transactions

Lista as transações do extrato de uma conta financeira, filtrando por período, tipo, valor e descrição.

Janela de datas — mudança agendada

Hoje, uma requisição sem datas devolve o extrato inteiro da conta. Esse comportamento vai mudar em 05/02/2027: a consulta passará a rodar sempre dentro de uma janela de no máximo 180 dias, o que é o que mantém o endpoint rápido em contas com histórico longo.

Você pode adotar o comportamento novo desde já enviando date_window=strict, e deve fazê-lo antes da data de corte. Com ele:

Parâmetros enviados	Janela consultada
nenhum	Os últimos 180 dias
só occurrence_date_from	180 dias a partir dela
só occurrence_date_to	180 dias antes dela
ambos	O período informado, desde que não passe de 180 dias

Um intervalo maior que 180 dias é recusado com 422 em vez de ser reduzido silenciosamente — um extrato parcial com aparência de completo é pior do que um erro. Para períodos mais longos, faça chamadas sucessivas de até 180 dias cada.

Enquanto date_window=strict não for enviado, nada muda. Requisições cujo resultado seria diferente sob a janela estrita respondem com os cabeçalhos Deprecation: true e Sunset: Fri, 05 Feb 2027 00:00:00 GMT — use-os para descobrir quais das suas integrações precisam de ajuste.

Request

Responses

200

Transações encontradas

422

Intervalo de datas maior que 180 dias (com date_window=strict)