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

# Limites e Cota

> Requisições por minuto e NFS-e de produção por mês.

## Requisições por minuto

Cada Conta tem um limite de requisições por minuto, somando todas as suas Chaves e a sessão do painel.
Ao estourar:

```http theme={null}
HTTP/1.1 429 Too Many Requests
Retry-After: 2

{"erro": {"codigo": "limite_de_requisicoes", "mensagem": "Muitas requisições; tente de novo em instantes."}}
```

Espere os segundos de `Retry-After` e repita. Para acompanhar Notas, consulte a cada poucos segundos em vez
de em laço contínuo.

## Cota mensal

A **Cota** é o número de NFS-e de **produção** que a Conta pode emitir no mês (horário de Brasília).
Homologação não conta.

```bash theme={null}
curl $NOTASX/v1/cota -H "Authorization: Bearer $CHAVE"
```

```json theme={null}
{"mes": "2026-11-01", "limite": 100, "usadas": 12, "pendentes": 3}
```

* `usadas`: NFS-e emitidas em produção no mês. Cada NFS-e desconta da Conta que criou a Nota.
* `pendentes`: Notas de produção ainda sem resultado. Elas **contam contra o limite** na hora de criar
  Notas novas, para você não passar da Cota com muitas Notas na fila.
* Rejeição e Falha não consomem Cota.

Quando `usadas + pendentes` chega ao `limite`, criar Nota em produção responde `429 cota_esgotada`, com
`Retry-After` em segundos até o início do próximo mês.


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