← Voltar para o início
API REST · JSON · Disponível agora

API de Consulta CNPJ para Desenvolvedores

Integre consulta de empresas, análise de risco, certidões (CND, CNDT) e protestos em cartórios no seu produto. Dados oficiais, resposta em JSON, prontos para KYC, due diligence e automação.

Em resumo: a API do Confere CNPJ é uma interface REST que permite consultar empresas brasileiras por CNPJ e receber dados cadastrais, certidões (CND e CNDT), score de confiança, alertas de risco e protestos em cartórios. Autenticação via API Key, respostas em JSON e pacotes de 50 ou 100 créditos. Crie sua conta, gere a chave em Minha conta → API e integre.

O que é a API do Confere CNPJ?

A API do Confere CNPJ expõe programaticamente tudo o que a plataforma oferece na interface web: consulta de dados cadastrais oficiais da Receita Federal, análise de risco empresarial com score de confiança, verificação de certidões negativas (CND federal e CNDT trabalhista), quadro societário e consulta de protestos em cartórios com cobertura nacional.

Foi projetada para desenvolvedores que precisam integrar verificação de empresas em produtos B2B — fintechs, ERPs, CRMs, plataformas de marketplace, sistemas de crédito e ferramentas de compliance. Em vez de navegar portais manualmente ou manter integrações frágeis com múltiplas fontes, você faz uma requisição HTTP e recebe um dossiê estruturado em JSON.

Como começar

1. Crie sua conta

Cadastro gratuito com e-mail. Sem cartão de crédito para começar.

2. Compre créditos

Em Minha conta → API, escolha pacote de consulta ou protestos e pague via PIX.

3. Gere sua API Key

Crie uma chave de produção na mesma seção. Copie na hora — ela só aparece uma vez.

4. Integre

Faça requisições REST com Bearer token. Cadastro Serpro na etapa 1; análise completa na etapa 2.

Consulta em duas etapas

A consulta é dividida em duas etapas: cadastro Serpro primeiro, análise completa depois — 1 crédito para as duas etapas.

Etapa 1

POST /api/v1/consulta

Debita 1 crédito. Retorna apenas dados cadastrais Serpro e um consultation_id.

Etapa 2 · 0 créditos

POST /api/v1/consulta/ia

Não debita crédito. Envia o consultation_id e recebe CND, CNDT, reputação, enrichment e dossiê completo.

Endpoints disponíveis

API v1 em produção. Autenticação via Authorization: Bearer sua_api_key.

POST/api/v1/consultaEtapa 1: dados cadastrais Serpro — debita 1 crédito, retorna consultation_id
POST/api/v1/consulta/iaEtapa 2: CND, CNDT, reputação e análise — usa consultation_id, NÃO debita crédito
POST/api/v1/protestosConsulta de protestos em cartórios — cobertura nacional

Exemplo de integração

Consulta em duas etapas: cadastro Serpro primeiro, análise completa depois:

# Etapa 1 — dados cadastrais Serpro
curl -X POST https://conferecnpj.com.br/api/v1/consulta \
  -H "Authorization: Bearer sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{"cnpj": "00000000000191"}'

# Resposta etapa 1
{
  "success": true,
  "consultation_id": "abc123",
  "status": "pending",
  "credits_remaining": 49,
  "data": { "cnpj_data": { "razao_social": "...", "situacao_cadastral": "ATIVA" } }
}

# Etapa 2 — CND, CNDT, reputação e IA (NÃO debita crédito)
curl -X POST https://conferecnpj.com.br/api/v1/consulta/ia \
  -H "Authorization: Bearer sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{"consultation_id": "abc123"}'

# Resposta etapa 2 (trecho)
{
  "credits_charged_this_request": 0,
  "consultation_credits_total": 1,
  "message": "Este endpoint não debita créditos..."
}

curl -X POST https://conferecnpj.com.br/api/v1/protestos \
  -H "Authorization: Bearer sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{"cnpj": "00000000000191"}'

Pacotes e preços

Compre créditos via PIX em Minha conta → API. A etapa 1 debita 1 crédito; a etapa /consulta/ia é gratuita (usa o mesmo consultation_id). Protestos usam créditos separados.

Consulta completa

  • 10 consultas APIPara testarR$ 59
  • 50 consultas APIR$ 229
  • 100 consultas APIrecomendadoR$ 399

Protestos

  • 10 protestos APIPara testarR$ 99
  • 50 protestos APIR$ 429
  • 100 protestos APIrecomendadoR$ 749

API de Protestos em Cartórios

Protestos são registros formais de dívidas não pagas em cartórios — um dos indicadores mais confiáveis de inadimplência comercial. Diferente da CND (débitos tributários federais), protestos revelam conflitos com credores privados.

Cobertura nacional

Consulta em cartórios de protesto de todos os 26 estados e do Distrito Federal num único endpoint — sem precisar integrar portais estaduais separados.

Resposta binária clara

Resultado "consta" ou "nada consta" com timestamp e metadados de cobertura — ideal para regras automáticas de aprovação/reprovação.

Saiba mais sobre protestos na página de consulta de protestos.

Dados disponíveis na API

Cadastro CNPJ

Razão social, nome fantasia, situação, CNAE, endereço, porte, natureza jurídica

Score de confiança

Pontuação 0–100 com base em múltiplos indicadores de risco

Alertas automáticos

Sinais de atenção: situação irregular, capital baixo, CNAE de risco, etc.

CND (Federal)

Certidão Negativa de Débitos — status e validade

CNDT (Trabalhista)

Certidão do TST — regularidade trabalhista

Quadro societário

Sócios, participação e qualificação

Protestos

Consulta nacional em cartórios de protesto (crédito separado)

Consulta em 2 etapas

Cadastro Serpro rápido + análise completa no mesmo crédito

Casos de uso

KYC e Onboarding

Valide CNPJ de clientes PJ no cadastro. Verifique situação cadastral, tempo de existência e sinais de risco antes de liberar conta ou crédito.

Due Diligence

Automatize a análise de fornecedores e parceiros. Cruze certidões, protestos e score de confiança sem pesquisa manual em múltiplos portais.

ERP e CRM

Enriqueça cadastros de empresas no seu sistema. Mantenha dados atualizados e alertas de risco sincronizados com cada CNPJ.

Análise de Crédito

Complemente score interno com dados externos: protestos, CND, CNDT e indicadores de saúde empresarial para decisões de crédito B2B.

Códigos de resposta comuns

401API Key inválida ou ausente
402Saldo insuficiente — compre créditos em /perfil
404CNPJ ou consultation_id não encontrado
409Análise de IA já em processamento
500Erro interno — etapa 1 estorna crédito; etapa 2 permite retry

Perguntas frequentes

O que a API do Confere CNPJ oferece?
A API REST permite consultar empresas brasileiras por CNPJ e receber dados cadastrais oficiais, score de confiança, alertas de risco, certidões (CND federal e CNDT trabalhista), quadro societário e, opcionalmente, consulta de protestos em cartórios com cobertura nacional. Tudo em JSON, pronto para integrar em fluxos de KYC, onboarding, análise de crédito e due diligence.
Como funciona a autenticação da API?
Autenticação via API Key no header Authorization (Bearer token). Apenas POST /api/v1/consulta debita 1 crédito. POST /api/v1/consulta/ia não debita créditos — usa o consultation_id da etapa 1.
A API de protestos cobre todos os estados do Brasil?
Sim. O endpoint de protestos consulta cartórios de protesto em todos os 26 estados e no Distrito Federal, consolidando o resultado ("consta" ou "nada consta") em uma única resposta — diferente de portais estaduais que cobrem apenas uma UF.
Qual a diferença entre consulta cadastral e análise completa na API?
A consulta em duas etapas: POST /api/v1/consulta debita 1 crédito e retorna dados Serpro. POST /api/v1/consulta/ia não gasta crédito — adiciona CND, CNDT, reputação e análise de risco usando o consultation_id. No total, 1 crédito por consulta completa.
Posso consultar CNPJs em lote via API?
Sim. Cada CNPJ é uma requisição independente. Pacotes de 10, 50 ou 100 créditos — comece com 10 para testar a integração.
POST /api/v1/consulta/ia gasta crédito?
Não. Apenas POST /api/v1/consulta debita 1 crédito de consulta. O endpoint /api/v1/consulta/ia usa o consultation_id retornado na etapa 1 e não debita saldo — mesmo em retentativas após erro. Uma consulta completa (etapas 1 + 2) custa 1 crédito no total.
A API está disponível agora?
Sim. Crie sua conta em conferecnpj.com.br, acesse Minha conta → API, gere sua API Key e compre créditos via PIX. Pacotes de 10, 50 ou 100 consultas e protestos.
A API é compatível com LGPD?
Sim. Processamos apenas dados públicos e oficiais de pessoas jurídicas. Fornecemos orientações de uso em conformidade com a LGPD para integrações em produtos B2B. Dados sensíveis de pessoas físicas (CPF de sócios) seguem regras específicas documentadas na API.

Pronto para integrar?

Crie sua conta, gere a API Key em Minha conta → API, compre créditos via PIX e faça sua primeira requisição. Sem formulário, sem espera.

Já tem API Key? Veja o exemplo de integração acima.