Fundamentos
Paginação
Listas são paginadas por número de página e sempre informam o total.
Parâmetros e resposta
page— começa em 1.pageSize— padrão 25, máximo 200.- Resposta:
{ data, total, page, pageSize }. Algumas listas trazem tambémsummarycom totais do filtro. - A ordem padrão é da mais recente para a mais antiga.
curl
curl "https://api2.bosspay.io/v1/transactions?from=2026-09-01&to=2026-09-30&method=PIX&page=2&pageSize=100" \
-H "Authorization: Bearer bp_live_SUA_CHAVE"200
{
"data": [ { "id": "cmu…", "object": "transaction", "status": "APPROVED", "amount": "15990", … } ],
"total": 338,
"page": 2,
"pageSize": 100,
"summary": [ { "currency": "BRL", "amount": "23176154", "fee": "391552", "net": "22784602" } ]
}Percorrendo tudo
Avance enquanto page × pageSize < total. Para grandes volumes prefira filtrar por período ou usar as exportações de Relatórios.