# Planos e Limites
> Comparação de planos e limites da FiscalAPI.
URL: https://docs.fiscalapi.com.br/docs/referencia/plans-and-limits
A FiscalAPI oferece quatro planos para atender desde desenvolvedores individuais até grandes empresas. Todos os planos incluem acesso à mesma API — a diferença está nos limites de uso e no nível de suporte.
## ## Comparação de planos
| Recurso | Lite | Starter | Pro | Enterprise |
| -------------------------------------------- | --------------------- | --------------------- | ---------------------- | ---------- |
| Preço | R$ 19,99/mês | R$ 50/mês | R$ 130/mês | R$ 250/mês |
| Consultas/mês (total) | 30 | 500 | 2.000 | 10.000 |
| Rate Limit | 5/min | 20/min | 60/min | 120/min |
| Chaves de API ativas | 2 | 3 | 10 | 25 |
| Recarga (por consulta) | — | R$ 0,12 | R$ 0,07 | R$ 0,02 |
| NF-e com certificado (por nota, na franquia) | 3 consultas · R$ 2,01 | 3 consultas · R$ 0,30 | 3 consultas · R$ 0,195 | R$ 0,025 |
| NF-e sem certificado (por nota, na franquia) | 3 consultas · R$ 2,01 | 3 consultas · R$ 0,30 | 3 consultas · R$ 0,195 | R$ 0,05 |
| NFS-e por chave (por nota, na franquia) | 3 consultas · R$ 2,01 | 3 consultas · R$ 0,30 | 3 consultas · R$ 0,195 | R$ 0,05 |
| Suporte | Email | Prioritário | Prioritário | Dedicado |
Conta sem plano ativo pode ter até **2** chaves de API ativas.
O limite mensal é **global** — conta o total de chamadas a qualquer endpoint (IE, CNPJ, Simples Nacional, CND, Perfil Produtor, SIGEF, NF-e, NFS-e). Não há limites separados por endpoint. Algumas consultas contam como mais de uma: a [NF-e com certificado](/docs/nfe/consultar-nfe-chave) conta como **3 consultas** por nota nos planos Lite, Starter e Pro; no Enterprise, sai a **R$ 0,025 por nota**, dentro das 10.000 consultas do plano. O [CNPJ ao vivo na Receita](/docs/enriquecimento/consultar-cnpj) conta como **3 consultas**.
A [NF-e sem certificado](/docs/nfe/consultar-nfe-xml-sem-certificado) conta como **3 consultas** por nota nos planos Lite, Starter e Pro; no Enterprise, sai a **R$ 0,05 por nota**. Ela não entra nas consultas grátis do mês.
A [NFS-e por chave](/docs/nfse/consultar-nfse) tem o mesmo preço da NF-e sem certificado, mas só cobra a nota entregue (nota não encontrada não é cobrada). No painel, entra nas consultas grátis do mês (gasta 1 das 10).
NF-e e CNPJ ao vivo têm preço próprio na recarga, informado no painel.
Contadores de uso são renovados a cada ciclo de 30 dias da assinatura (a partir da data de contratação), não no primeiro dia do mês.
## ## Consultas grátis
Conta que nunca assinou plano, com e-mail confirmado e sem recarga, tem **10 consultas grátis por mês, só no painel**. Pela API (chave `X-API-Key`), o MCP, os SDKs e o Postman, toda consulta pede plano ou recarga, a partir de R$ 19,99/mês. No painel, um só contador vale para qualquer consulta avulsa: IE em um estado, CNPJ (inclusive ao vivo), Simples Nacional, NFS-e, CND estadual de um estado, CND Federal, CNDT, CRF/FGTS, Perfil do Produtor, CNIR e SIGEF.
* Cada consulta entregue gasta 1 das 10, mesmo as que custam 3 num plano. Erro não gasta.
* Ficam fora: [NF-e sem certificado](/docs/nfe/consultar-nfe-xml-sem-certificado), [IE em todos os estados](/docs/consulta-ie/consultar-ie-todos), [CND de todos os estados](/docs/cnd/consultar-cnd-todos), [todas as certidões de uma vez](/docs/certidoes-federais/certidoes-todas) e as consultas em lote (IE por planilha, NF-e em lote).
* À parte, **10 XML de [NF-e com certificado](/docs/nfe/consultar-nfe-chave) por mês**, também só no painel.
* As grátis renovam no dia 1º de cada mês. Acabam na primeira assinatura e não voltam depois de cancelar.
## ## Monitoramento de uso
Acompanhe seu consumo em tempo real pelo [Dashboard](https://app.fiscalapi.com.br?utm_source=docs\&utm_medium=docs\&utm_campaign=plans-and-limits). A página de uso exibe:
* Quantidade de requisições realizadas por endpoint
* Percentual do limite mensal utilizado
* Histórico de consumo dos últimos 30 dias
## ## Quando o limite é excedido
Quando a franquia do mês e a recarga não cobrem a consulta, a API retorna HTTP `402 Payment Required`:
```json
{
"error": "LIMITE_ATINGIDO",
"usage": 500,
"limit": 500,
"plan": "starter",
"extra_credits": 0,
"cost": 1,
"consultas_restantes": 0,
"message": "Seu saldo não cobre esta consulta. Faça uma recarga no painel ou mude de plano."
}
```
| Campo | Descrição |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `error` | Sempre `LIMITE_ATINGIDO`. |
| `limit` | Consultas por mês do plano. |
| `plan` | Plano da conta (`lite`, `starter`, `pro`, `enterprise`). |
| `consultas_restantes` | Quantas consultas deste tipo o saldo (franquia do mês e recarga) ainda cobre. Use este campo para saber o que ainda cabe no saldo. |
| `message` | Mensagem pronta para exibir ao usuário. |
| `usage`, `extra_credits`, `cost` | Mantidos por compatibilidade com integrações antigas. Não use esses campos para calcular o saldo. |
## ## Upgrade de plano
Para aumentar seus limites:
1. Acesse o [Dashboard](https://app.fiscalapi.com.br?utm_source=docs\&utm_medium=docs\&utm_campaign=plans-and-limits)
2. Navegue até **Configurações** > **Assinatura**
3. Escolha o novo plano e confirme
O upgrade é aplicado imediatamente e os novos limites entram em vigor na hora. Você só será cobrado proporcionalmente ao período restante do mês.
Depois de criar a conta e confirmar o e-mail, você já tem as 10 consultas grátis do mês no painel. Para usar a API, é preciso plano ou recarga; em produção, recomendamos o plano **Starter** ou superior.
## ## Perguntas frequentes
### ### Os limites são por API Key ou por conta?
Os limites são por **conta** (usuário). Créditos, franquia do mês e rate limit são da conta: se você tiver várias API Keys, o uso de todas elas é somado. O Dashboard mostra quanto cada chave consumiu no mês.
### ### Quantas API Keys posso ter?
Depende do plano: 2 em conta sem plano ativo e no Lite, 3 no Starter, 10 no Pro e 25 no Enterprise, contando só as chaves ativas. Chaves revogadas não contam. Ao atingir o limite, revogue uma chave que não usa mais ou mude de plano. Se você mudar para um plano com limite menor, as chaves que já existem continuam funcionando; só não dá para criar novas até ficar abaixo do limite. Veja [Autenticação](/docs/getting-started/authentication#várias-chaves-por-conta). Para testes, há também as chaves de homologação: veja [Homologação](/docs/getting-started/homologacao).
### ### Posso comprar mais consultas?
Sim. Assinantes **Starter**, **Pro** e **Enterprise** podem recarregar a quantidade de consultas que quiserem direto no [Dashboard](https://app.fiscalapi.com.br?utm_source=docs\&utm_medium=docs\&utm_campaign=plans-and-limits) (Starter R$ 0,12 por consulta, Pro R$ 0,07, Enterprise R$ 0,02; NF-e e CNPJ ao vivo têm preço próprio, informado no painel). Escolha um dos pacotes prontos ou digite a quantidade, a partir do menor pacote do plano, em múltiplos de 100 e até 2 milhões por compra, pagando por PIX ou cartão. A recarga não expira e só é usada depois que a franquia do plano acaba. O plano Lite não tem recarga — o caminho é fazer upgrade. Para negociar preço em volumes maiores, entre em contato pelo email [contato@fiscalapi.com.br](mailto:contato@fiscalapi.com.br).
### ### O que acontece com consultas em cache?
Consultas respondidas pelo cache **cobram o custo normal da consulta** — 1 consulta na maioria dos endpoints; na NF-e com certificado, 3 consultas (Lite, Starter, Pro) ou R$ 0,025 por nota no Enterprise — pois toda resposta com dado útil conta no limite mensal (erros e consultas sem dado não são cobrados). O benefício do cache é a velocidade: a resposta vem em milissegundos, sem ida ao portal de origem. Você identifica uma resposta de cache pelo campo `cached: true`.