Saltar para o conteúdo principal
GET
curl
O endpoint Listar transações da Didit lê as transações de uma conta num intervalo de datas, lançadas e pendentes, com paginação por token de página. Os montantes são cadeias de caracteres decimais e os campos que um banco não envia são null. Para manter uma cópia sincronizada, use o fluxo de alterações em vez de voltar a ler os intervalos.

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, obtida em Developers -> API keys na Business Console. A chave principal tem acesso total. Uma chave com nome pode ter o âmbito limitado: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou apenas a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que não foi enviada nenhuma chave, que a chave não tem acesso a este recurso ou ação, ou que o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe os URLs de imagem, vídeo e PDF como null, e uma chave sem escrita em sessões recebe os links e tokens de sessão como null. Consulte 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 se a omitir.

status
enum<string>

Apenas transações lançadas ou apenas transações pendentes. Predefinição: ambas.

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

Tamanho da página, de 1 a 500. Predefinição 100.

Intervalo necessá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 as transações incluídas, e cada uma é servida no seu estado atual; uma transação removida durante a paginação deixa de aparecer nas páginas seguintes e é reportada pelo feed de alterações.

items
object[]
obrigatório

Ordenado por effective_date de forma decrescente e, depois, por id.

next_page_token
string | null
obrigatório

Continua esta leitura. Fixa o instantâneo da primeira página, tem a duração de uma hora e fica associado à aplicação, ao ambiente, à conta e aos filtros da leitura.

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