Todos os endpoints da Valut que retornam listas utilizam paginação baseada em cursor, garantindo performance e consistência mesmo com grandes volumes de dados.
Parâmetros de Paginação#
A navegação entre páginas é feita através dos seguintes parâmetros:starting_after: retorna os registros após o ID informado
ending_before: retorna os registros antes do ID informado
⚠️ Os parâmetros starting_after e ending_before são mutuamente exclusivos — apenas um pode ser utilizado por requisição.
Ordenação#
Os objetos são retornados em ordem cronológica decrescente, ou seja:Primeiro: registros mais recentes
Último: registros mais antigos
Limite de Registros#
Você pode controlar o número de itens por página utilizando o parâmetro:
Estrutura de Resposta#
As respostas incluem o campo:true → existem mais páginas disponíveis
⚠️ Importante — Consistência de Saldos#
Os endpoints de listagem de transações (ex: transferências, pagamentos, movimentações) não devem ser utilizados para reconstrução de saldo contábil.A Valut utiliza um modelo de ledger interno onde:Existem múltiplos fatores que impactam o saldo (não apenas transferências)
Eventos internos podem afetar a posição financeira
Operações podem ter estados intermediários (pending, settled, reversed)
Exemplo de Paginação#
1. Primeira requisição#
Modificado em 2026-04-26 00:18:38
