> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useaira.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Paginação e limites

> Percorra as listas da API página a página e entenda os limites de leitura por workspace e o limite de requisições por endereço IP.

> As listas da API devolvem uma página por requisição. Cada workspace tem limites de leitura, e cada endereço IP tem um limite de requisições.

## Paginação

Para ler uma lista inteira, comece com `offset=0`, some o `limit` ao `offset` a cada página e pare quando a resposta trouxer `hasMore: false`.

Se a lista muda enquanto você a percorre, uma página pode repetir ou pular um item. Nas listas que começam pelos itens mais novos, como a de faturas, um item criado durante a leitura faz a página seguinte repetir o último item que você leu, e um item que sai da lista, como uma fatura que muda para um status fora do filtro, faz a página seguinte pular um item. Descarte os itens repetidos pelo `id`.

## Limites de leitura por workspace

Cada workspace pode ter até 20 leituras em andamento ao mesmo tempo e fazer até 50 leituras por segundo, somando todas as suas chaves de API. Uma leitura é uma requisição `GET` ou `HEAD`, e fica em andamento desde que chega à Aira até a resposta terminar de ser enviada.

Uma leitura acima de um desses limites recebe o status `429`, com o header `Retry-After` e um `code` que nomeia o limite atingido, como descreve [Respostas de erro](https://docs.useaira.com/api-reference/error-responses.md#limites-de-leitura). O limite de leituras em andamento só aceita uma nova leitura quando outra termina, então leia poucas páginas ao mesmo tempo.

## Limite por endereço IP

Antes de chegar à API, cada requisição, de leitura ou de gravação, passa por um firewall que conta as requisições de cada endereço IP. Um endereço IP que faz mais de 5.000 requisições em 5 minutos recebe o status `429` em todas as requisições, até que a contagem dos últimos 5 minutos volte a ficar abaixo do limite. Um `429` sem um dos códigos dos limites de leitura vem desse limite: espere alguns minutos e reduza o ritmo das requisições.

## Próximos passos

* [Respostas de erro](https://docs.useaira.com/api-reference/error-responses.md) — formato de erros e códigos de status


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.