Consulta de CNPJ por API

API de Consulta de CNPJ com a situação cadastral na Receita Federal

Envie o CNPJ, numérico ou alfanumérico. Receba razão social, nome fantasia, situação cadastral, atividades, natureza jurídica, capital social e endereço em uma resposta só, com webhook assinado, sandbox grátis e contingência automática entre fontes.

Criar conta Ver a documentação

Período de teste de 14 dias, com cota de 100 consultas por mês. O sandbox é grátis e não consome cota. O cadastro está em piloto, por convite: para participar, fale com a gente.

RequisiçãoPOST /v1/consultations

curl -X POST https://api.procnpj.com.br/v1/consultations \
  -H "Authorization: Bearer pcnpj_test_..." \
  -H "Content-Type: application/json" \
  -d '{"cnpj": "11.222.333/0006-96"}'

Resultado, no sandboxGET /v1/consultations/{id}

{
  "status": "done",
  "outcome": "found",
  "result": {
    "legal_name": "EMPRESA DE EXEMPLO LTDA",
    "registration_status": "ativa",
    "main_activity": "62.01-5-01 - ...",
    "address": { "city": "SAO PAULO", ... }
  }
}

O que volta na resposta

Um desfecho claro e os dados cadastrais quando o CNPJ é encontrado

Toda consulta concluída termina em um de dois desfechos. Você programa a regra em cima de códigos estáveis, sem interpretar texto.

CNPJ encontrado

O CNPJ existe no cadastro. O resultado vem completo, com a situação cadastral.

found

CNPJ não encontrado

O número passa na conta dos dígitos verificadores, mas não existe no cadastro.

not_found

CNPJ alfanumérico aceito

O campo cnpj aceita o formato numérico e o alfanumérico, com ou sem máscara, desde o primeiro dia. Sem versão nova da API.

Ver a regra e os CNPJs de teste

Campos do resultado, quando o CNPJ é encontrado

legal_name: Razão social.
trade_name: Nome fantasia, quando houver.
registration_status: Situação cadastral em código: ativa, baixada, suspensa, inapta, nula ou desconhecida.
registration_status_label: Situação cadastral por extenso, pronta para exibir.
registration_status_date: Data da situação cadastral, em AAAA-MM-DD.
opening_date: Data de abertura, em AAAA-MM-DD.
head_office: true para matriz, false para filial e null quando a fonte não informa.
legal_nature: Natureza jurídica.
main_activity: Atividade econômica principal (CNAE), com código e descrição.
secondary_activities: Lista das atividades econômicas secundárias (CNAE).
share_capital: Capital social, em texto.
address: Endereço do estabelecimento: street, number, complement, district, city, state e zip_code.

Situações cadastrais devolvidas:

AtivaBaixadaSuspensaInaptaNula

Como funciona

Três passos: criar, receber o aviso, buscar o resultado

A consulta é assíncrona. Seu sistema não fica preso esperando a fonte responder.

Crie a consulta

Envie cnpj com a sua chave. Se quiser, mande também uma referência sua em external_reference e o cabeçalho Idempotency-Key, para repetir a chamada sem criar outra consulta.

A API responde 202 na hora, com a consulta na fila.

cURLPOST /v1/consultations

curl -X POST https://api.procnpj.com.br/v1/consultations \
  -H "Authorization: Bearer pcnpj_test_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: fornecedor-8841" \
  -d '{"cnpj": "11.222.333/0006-96",
       "external_reference": "fornecedor-8841"}'

# 202 Accepted
{"id": "3f0e6a52-9c1b-4d7e-8a35-2b6f1c9d4e70",
 "status": "pending", "outcome": null, ...}

Receba o aviso por webhook

Quando a consulta termina, o ProCNPJ envia o evento consultation.completed ou consultation.failed para o seu endereço, assinado com HMAC-SHA256.

O webhook leva só o id e o status, nunca o dado cadastral. Se preferir não usar webhook, consulte o id de tempos em tempos.

Webhookconsultation.completed

X-ProCNPJ-Signature: sha256=9c1f...
X-ProCNPJ-Timestamp: 1790787795

{"event": "consultation.completed",
 "id": "3f0e6a52-9c1b-4d7e-8a35-2b6f1c9d4e70",
 "status": "done",
 "outcome": "found",
 "external_reference": "fornecedor-8841",
 "sandbox": true, ...}

Busque o resultado

Com o id em mãos, uma chamada autenticada devolve o desfecho e, quando o CNPJ é encontrado, os dados cadastrais da empresa, com o endereço em campos separados.

Ver o guia completo, com Python e verificação de assinatura

cURLGET /v1/consultations/{id}

ID=3f0e6a52-9c1b-4d7e-8a35-2b6f1c9d4e70
curl https://api.procnpj.com.br/v1/consultations/$ID \
  -H "Authorization: Bearer pcnpj_test_..."

# 200 OK
{"id": "3f0e6a52-9c1b-4d7e-8a35-2b6f1c9d4e70",
 "status": "done",
 "outcome": "found",
 "cnpj": "11.222.333/0006-96",
 "external_reference": "fornecedor-8841",
 "sandbox": true,
 "result": {
   "legal_name": "EMPRESA DE EXEMPLO LTDA",
   "trade_name": "EXEMPLO",
   "registration_status": "ativa",
   "registration_status_label": "Ativa",
   "registration_status_date": "2010-05-03",
   "opening_date": "2010-05-03",
   "head_office": true,
   "legal_nature": "206-2 - Sociedade Empresária Limitada",
   "main_activity": "62.01-5-01 - Desenvolvimento de programas de computador sob encomenda",
   "secondary_activities": ["62.02-3-00 - Desenvolvimento e licenciamento de programas customizáveis"],
   "share_capital": "100000.00",
   "address": {"street": "AVENIDA DE EXEMPLO", "number": "1000", "complement": "SALA 1",
               "district": "CENTRO", "city": "SAO PAULO", "state": "SP", "zip_code": "01000-000"}
 },
 "error": null,
 "personal_data_purged": false,
 "created_at": "2026-09-30T17:03:11.482913+00:00",
 "finished_at": "2026-09-30T17:03:15.127406+00:00"}

Sandbox grátis

Teste todos os desfechos antes de gastar uma consulta

Chaves pcnpj_test_ usam um simulador: não consultam dado real, não custam nada e não consomem cota. O décimo segundo caractere do CNPJ, o último antes dos dígitos verificadores, escolhe o cenário.

O fluxo é o mesmo da produção, com fila, webhook e resultado. Quando a integração estiver pronta, basta trocar a chave por uma pcnpj_live_.

Criar conta e gerar chave de teste

Cenários do sandbox pelo décimo segundo caractere do CNPJ
12º caractere	Cenário simulado
0	CNPJ não encontrado
2	Situação baixada
3	Situação suspensa
4	Situação inapta
5	Situação nula
9	Falha simulada (a consulta termina como failed)
Qualquer outro	Situação ativa

Contingência

Se uma fonte falha, a consulta segue para a próxima

O ProCNPJ faz a consulta da situação cadastral do CNPJ na Receita Federal com contingência automática entre três fontes: a primeira é a consulta em tempo real na Receita Federal. Você integra uma API e não precisa programar o plano B.

Troca automática de fonte

Quando a primeira fonte não responde, a mesma consulta é tentada na seguinte, sem nenhuma ação do seu lado.

Falha não é cobrada

Se nenhuma fonte responde, a consulta termina como falha. Ela não é cobrada e não consome a sua cota.

Repetir sem duplicar

Com o cabeçalho Idempotency-Key, repetir a mesma chamada devolve a consulta que já existe, sem novo custo.

Segurança e LGPD

CNPJ é público, mas o resultado pode ter dado de pessoa. O ProCNPJ guarda o mínimo, cifrado, pelo tempo necessário

O cadastro de um microempreendedor ou empresário individual traz nome e endereço de uma pessoa. Você é o controlador dos dados que consulta; o ProCNPJ atua como operador e foi desenhado para reduzir o que fica guardado.

Ver a página de segurança

Resultado da consulta cifrado por cliente.
CNPJ, referência e resultado apagados depois de 90 dias.
Isolamento total entre clientes: cada conta só enxerga as próprias consultas.
Trilha de auditoria das ações da conta.
Chave de API exibida uma única vez: o banco guarda só o hash.
Webhook assinado, sem dado cadastral no corpo.

Para que serve

Onde a consulta de CNPJ entra no seu fluxo

Cada página abaixo mostra o que a consulta resolve naquele uso e, com a mesma clareza, o que ela não resolve.

Onboarding de pessoa jurídica (KYB)

A primeira pergunta do cadastro de uma empresa respondida por API: o CNPJ existe, está ativo e a razão social bate?

Ver este uso

Emissão de nota fiscal e validação fiscal

Situação cadastral, razão social e endereço do cliente conferidos antes de a nota ser emitida.

Ver este uso

Homologação de fornecedores

Situação cadastral, tempo de empresa, atividade e endereço do fornecedor antes de fechar o contrato.

Ver este uso

Autopreenchimento de cadastro

O cliente digita o CNPJ e o formulário recebe razão social, nome fantasia, endereço e atividade.

Ver este uso

API de CNPJ alfanumérico

CNPJ com letras e números aceito desde o primeiro dia, no mesmo campo e na mesma chamada do CNPJ numérico.

Ver este uso

Consulta pela tela, sem código

O console permite consultar pela tela, gerar chaves, cadastrar webhooks, acompanhar o consumo e organizar a equipe por papéis.

Abrir o console

Perguntas frequentes

O que perguntam antes de integrar

O que é o ProCNPJ?

O ProCNPJ é uma API de consulta de CNPJ. Você envia o CNPJ e recebe a situação cadastral na Receita Federal, a razão social, o nome fantasia, a data de abertura, a natureza jurídica, as atividades econômicas (CNAE), o capital social e o endereço do estabelecimento.

Quais dados preciso enviar para consultar um CNPJ?

Só o CNPJ, numérico ou alfanumérico, com ou sem máscara. Você também pode enviar uma referência sua (external_reference), que volta na resposta e no webhook, e o cabeçalho Idempotency-Key, para repetir a chamada sem criar outra consulta.

Quais são os resultados possíveis de uma consulta?

Uma consulta concluída termina em um de dois desfechos: CNPJ encontrado ou CNPJ não encontrado. Quando o CNPJ é encontrado, a situação cadastral pode ser ativa, baixada, suspensa, inapta ou nula, e o resultado traz a data dessa situação.

Como recebo o resultado da consulta?

A consulta é assíncrona. A criação responde na hora com a consulta na fila, e o desfecho chega de duas formas: por webhook assinado com HMAC-SHA256, que avisa o id e o status, ou consultando a API pelo id. O webhook não leva dado cadastral: o resultado é buscado por uma chamada autenticada.

Posso testar sem pagar?

Sim. Toda conta nasce com período de teste de 14 dias e cota de 100 consultas por mês. Além disso, o sandbox é grátis e não consome cota: com uma chave de teste, o décimo segundo caractere do CNPJ escolhe o cenário simulado, como não encontrado, baixada, suspensa, inapta, nula ou ativa.

O que acontece se a fonte da consulta estiver fora do ar?

O ProCNPJ tem contingência automática entre três fontes: a primeira é a consulta em tempo real na Receita Federal e, se ela falha, a consulta segue para a próxima. Se nenhuma fonte responde, a consulta termina como falha, não é cobrada e não consome cota.

Quanto custa?

A tabela de preços ainda está sendo fechada e será publicada na página de preços. Enquanto isso, o período de teste e o sandbox permitem integrar e avaliar o produto. O que conta como uso é a consulta concluída: sandbox e consulta que termina em falha não contam.

Como o ProCNPJ trata os dados da consulta?

O CNPJ é um dado público, mas o cadastro de um microempreendedor ou empresário individual pode conter nome e endereço de uma pessoa. Por isso o resultado fica cifrado por cliente e os dados da consulta são apagados depois de 90 dias. Cada cliente só enxerga as próprias consultas, e as ações ficam registradas em trilha de auditoria.

A API aceita o CNPJ alfanumérico?

Sim, desde o primeiro dia. O campo cnpj aceita o CNPJ numérico e o alfanumérico, com ou sem máscara, e os dígitos verificadores são validados pela regra nova antes de a consulta entrar na fila. No sandbox, 12.ABC.345/01DE-35 é um CNPJ alfanumérico válido para testar.

O ProCNPJ tem vínculo com a Receita Federal?

Não. O ProCNPJ é um serviço privado, sem vínculo com a Receita Federal nem com órgão de governo. O que ele entrega é a consulta da situação cadastral do CNPJ na Receita Federal, com contingência automática entre fontes.

Faça a primeira consulta hoje, no sandbox

Crie a conta, gere uma chave de teste e veja os desfechos chegando por webhook. Sem custo e sem consumir cota.

Criar conta Ver a documentação

Cadastro em piloto, por convite. Para participar, fale com a gente.