Basic
Todos os campos cadastrais armazenados da Receita, com sócios e Simples/MEI. Para preencher e conferir cadastros.
/v2/empresas/02709449/basic
api pública · v2 · gratuita
Leve o cadastro da Receita e os registros públicos de empresas brasileiras para sua aplicação. Do preenchimento de um cadastro à consulta completa, com uma única chave.
Sem cartão. Consumo na sua conta. A mesma chave da v1.
Defina CNPJ_API_KEY no seu servidor:
curl --fail-with-body \
-H "Authorization: Bearer $CNPJ_API_KEY" \
https://api.cnpj.ai/v2/estabelecimentos/02709449000159/full
Cadastro, sócios, Simples e primeira página de cada fonte. Continue pelas próximas páginas quando houver mais registros.
Python, com requests e a chave no ambiente:
import os
import requests
r = requests.get(
"https://api.cnpj.ai/v2/estabelecimentos/02709449000159/full",
headers={"Authorization": f"Bearer {os.environ['CNPJ_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())
Node.js, em um módulo .mjs no servidor:
const r = await fetch(
"https://api.cnpj.ai/v2/estabelecimentos/02709449000159/full",
{
headers: {
Authorization: `Bearer ${process.env.CNPJ_API_KEY}`
},
signal: AbortSignal.timeout(30000)
}
);
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());
HTTPS · JSON · chave usada no backend
o que sua aplicação precisa?
Escolha o cadastro, o conjunto completo ou os registros de uma fonte. Cada consulta conta como uma chamada.
Todos os campos cadastrais armazenados da Receita, com sócios e Simples/MEI. Para preencher e conferir cadastros.
/v2/empresas/02709449/basic
O basic e todas as fontes de registros públicos, organizadas por tema. Cada coleção traz sua primeira página.
/v2/empresas/02709449/full
Consulte só o que precisa: dívida ativa, contratos públicos, financiamentos e outras fontes, com paginação própria.
/v2/empresas/02709449/fontes/pgfn
o escopo certo, desde a URL
A raiz identifica a empresa. O CNPJ completo identifica um único estabelecimento. Basic, full e fontes funcionam nos dois.
Cadastro compartilhado, sócios, Simples e a coleção de estabelecimentos da mesma raiz.
/v2/empresas/02709449/fullUma matriz ou filial exata, com seus registros públicos e os dados compartilhados da empresa.
/v2/estabelecimentos/02709449000159/fullFontes com CNPJ completo respeitam o estabelecimento consultado. Habilitação aduaneira só existe por empresa e vem identificada com esse escopo.
além do cadastro
Cada fonte informa competência, disponibilidade e proveniência. Você sabe de onde vem o dado e qual carga está consultando.
Inscrições, situação e valores da dívida ativa da União.
PGFNRegistros da CGU e AGU, com processos e abrangência.
CEIS · CNEP · CEPIM · LeniênciaCadastro de empregadores e acordos, com históricos publicados.
MTE · CEACModalidade e limite publicados para a empresa.
Habilitação aduaneiraCampos processuais e registros de fiscalização ambiental.
Ibama · Autos e embargosCadastro de empresas e cooperativas transportadoras.
ANTT · RNTRCContratos como fornecedor, subcontratado ou órgão contratante.
PNCP · Participante e órgãoOperações, condições, valores contratados e desembolsados.
BNDESFonte indisponível não significa ausência de registros. O retorno sinaliza cargas ausentes ou desatualizadas. Ver catálogo das 14 fontes →
feito para integrar
De 1 a 100 itens por coleção, com 20 por padrão. Continue pela proxima_url até o fim.
Contrato v2 e OpenAPI próprios. A v1 continua disponível para quem já integrou.
Crie até 5 chaves ativas, acompanhe o consumo e revogue acessos quando precisar.
Disponibilidade e origem em cada fonte. Os registros preservam vínculos e documentos publicados.
comece com uma consulta
Crie uma chave na sua conta, configure no backend e faça a primeira chamada.
Começar gratuitamenteSem cartão e sem cota mensal inicial.
A cota é compartilhada entre chaves, v1 e v2. Cada página e chamada admitida conta, inclusive respostas de erro.