Visão geral
O que a CNPJ API oferece, quais fontes integra e como a documentação está organizada.
A CNPJ API expõe snapshots publicados de cinco domínios de dados públicos oficiais: CNPJ, PGFN, Receita Federal, CNO e CAFIR. A API consulta somente versões publicadas; uma coleta nova que falhe não substitui o último snapshot válido.
O que existe hoje
- perfil cadastral por CNPJ, com empresa, estabelecimento, Simples/MEI e resumos;
- matriz, filiais e quadro societário por raiz de CNPJ;
- inscrições em dívida ativa da PGFN por CNPJ e categoria;
- parcelamentos e transações tributárias da RFB por CNPJ;
- créditos ativos da RFB em dados agregados;
- obras CNO por número ou CNPJ responsável, com áreas, CNAEs e vínculos;
- imóveis CAFIR por NIRF ou listagem por UF e município;
- saúde operacional e versão publicada de cada fonte.
Não existe hoje busca por razão social ou nome fantasia. Também não há webhooks, escrita de dados públicos ou endpoints destrutivos na referência pública.
Convenções
| Item | Convenção |
|---|---|
| Base de dados | /v1 |
| Formato | JSON, chaves em snake_case |
| CNPJ | 14 dígitos, sem máscara e com dígitos verificadores válidos |
| Paginação | limite e offset |
| Autenticação | X-API-Key quando habilitada no ambiente |
| Precisão decimal | valores monetários e métricas decimais são strings |
| Cache | respostas GET podem incluir ETag e X-Cache |
Próximos passos
- Faça a primeira chamada.
- Entenda como proteger sua API key.
- Escolha um caso de uso.
- Consulte a referência gerada do OpenAPI.
Os dados documentados têm origem em fontes públicas oficiais. A API não substitui análise jurídica, fiscal ou de crédito e não garante que uma fonte pública esteja completa ou atualizada fora de sua periodicidade de publicação.