# Limites de uso

Os limites protegem a plataforma e a comunicação com a Sefin Nacional.

| Limite | Valor |
| --- | --- |
| Requisições por chave de API ou token OAuth | 300 a cada 5 minutos |
| Requisições por endereço IP | 300 a cada 5 minutos |
| Leitura de uma nota (`GET /invoices/:id`, `get_invoice`) | 60 por minuto |
| DANFSe | 30 por minuto |
| Consulta de CEP | 30 por minuto |
| Consulta de CNPJ (`lookup_company`) | 20 por minuto |
| Entrar (por IP e por e-mail) | 5 por minuto |

## Cabeçalhos

As respostas da API, do servidor MCP e do OAuth trazem o limite mais próximo de acabar:

```http
RateLimit-Limit: 300
RateLimit-Remaining: 287
RateLimit-Reset: 112
RateLimit-Policy: 300;w=300
```

- `RateLimit-Reset`: segundos até a janela recomeçar.
- `RateLimit-Policy`: limite e janela (`w`) em segundos.

## Resposta 429

```http
HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: 112
```

```json
{ "title": "Muitas requisições. Tente novamente em alguns minutos.", "status": 429, "code": "rate_limited", "errors": [] }
```

Espere os segundos de `Retry-After` antes de tentar de novo. Para acompanhar a emissão, prefira [webhooks](/docs/webhooks) a consultas repetidas.