Pular para o conteúdo

Paginação

Toda rota que devolve lista na API usa os mesmos dois parâmetros e o mesmo bloco meta.

Parâmetro O que faz
page a página, começando em 1
per_page quantos itens por página — até 100; o padrão é 25
{
"object": "list",
"data": [ "…" ],
"meta": {
"page": 1,
"per_page": 25,
"has_more": true
}
}

Avance page enquanto meta.has_more for true:

$pagina = 1;
do {
$resposta = consultar([
'sent_since' => '2026-10-01',
'per_page' => 100,
'page' => $pagina,
]);
foreach ($resposta['data'] as $item) {
processar($item);
}
$pagina++;
} while ($resposta['meta']['has_more']);

per_page acima de 100 é reduzido para 100; zero ou negativo volta para o padrão de 25. A resposta diz, em meta.per_page, qual valor foi aplicado — confira ali em vez de supor que o que você mandou foi aceito.