Paginação

Todas as listagens usam paginação por cursor — nunca offset.

Parâmetro	Tipo	Padrão	Descrição
`limit`	integer	20	Entre 1 e 100.
`starting_after`	string	—	Cursor opaco devolvido em next_cursor.

Envelope

{
  "object": "list",
  "data": [ /* ... */ ],
  "has_more": true,
  "next_cursor": "MjAyNi0wNy0zMFQxMjowMDowMFp8YTFiMg"
}

Quando has_more é false, next_cursor vem null. Os itens são ordenados do mais recente para o mais antigo.

Percorrendo todas as páginas

curl "https://pitra.com.br/api/public/v1/sales?limit=100" \
  -H "Authorization: Bearer sk_live_..."

curl "https://pitra.com.br/api/public/v1/sales?limit=100&starting_after=MjAyNi0wNy0zMFQxMjowMDowMFp8YTFiMg" \
  -H "Authorization: Bearer sk_live_..."

Um cursor inválido devolve 400 invalid_request. Não construa cursores manualmente: use sempre o valor de next_cursor.