Pular para o conteúdo principal
GET
curl
O endpoint List Transactions da Didit lê as transações de uma conta em um intervalo de datas, tanto lançadas quanto pendentes, com paginação por token de página. Os valores são strings decimais, e os campos que um banco não envia vêm como null. Para manter uma cópia sincronizada, use o feed de mudanças em vez de ler os intervalos novamente.

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, obtida em Developers -> API keys no Business Console. A chave principal tem acesso completo. Uma chave nomeada pode ter escopo limitado: nenhum, leitura ou escrita por recurso, restrita a alguns fluxos ou a sessões aprovadas, a uma lista de endereços e a uma data de validade. 401 significa que a chave está incorreta, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição partiu de um endereço fora da lista de endereços da chave; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status permitidos para a chave. Uma chave sem acesso a mídia recebe as URLs de imagem, vídeo e PDF como null, e uma chave sem escrita de sessões recebe os links e tokens de sessão como null. Veja https://docs.didit.me/console/api-keys.

Parâmetros de caminho

account_id
string<uuid>
obrigatório

O ID da conta.

Parâmetros de consulta

date_from
string<date>

Primeira data efetiva a incluir, inclusive.

date_to
string<date>

Última data efetiva a incluir, inclusive. Sem limite superior quando você omitir este campo.

status
enum<string>

Somente transações lançadas ou somente transações pendentes. Padrão: ambas.

Opções disponíveis:
booked,
pending
limit
integer
padrão:100

Tamanho da página, de 1 a 500. Padrão: 100.

Intervalo obrigatório: 1 <= x <= 500
page_token
string

O next_page_token da página anterior.

Resposta

Uma página de transações.

Uma página de uma leitura por intervalo de datas. A primeira página fixa quais transações são incluídas, e cada uma é entregue em seu estado atual; uma transação removida durante a paginação sai das páginas seguintes e é informada pelo feed de alterações.

items
object[]
obrigatório

Ordenado por effective_date decrescente e, depois, por id.

next_page_token
string | null
obrigatório

Continua esta leitura. Fixa o instantâneo da primeira página, vale por uma hora e fica vinculado à aplicação, ao ambiente, à conta e aos filtros da leitura.

has_more
boolean
obrigatório
Última modificação em 22 de novembro de 2026