O que é uma API de Consulta CNPJ?

Uma API de consulta CNPJ é uma interface de programação que permite que sistemas, plataformas e aplicações consultem dados cadastrais de empresas brasileiras de forma automatizada — sem precisar acessar manualmente o portal da Receita Federal.

Com uma única chamada a um endpoint, sua aplicação recebe de volta um JSON estruturado com informações como razão social, situação cadastral, endereço, quadro societário, atividades econômicas, contatos e muito mais.

Esse tipo de integração é essencial para empresas que precisam:

• ✓ Validar cadastros de clientes PJ no onboarding
• ✓ Enriquecer bases de dados com informações corporativas confiáveis
• ✓ Automatizar due diligence em processos de crédito, compliance e KYC/KYB
• ✓ Detectar fraudes com rapidez e precisão na validação de sócios
• ✓ Verificar situação cadastral ativa antes de qualquer transação comercial

Por Que a Maioria das APIs de CNPJ Entrega Dados Incompletos?

A maior parte das soluções do mercado funciona da mesma forma: raspa os dados públicos da Receita Federal e os entrega como estão — sem enriquecimento, sem verificação cruzada, sem visão do risco jurídico da empresa consultada.

O resultado é previsível: dados desatualizados, sócios mascarados, endereços incorretos e nenhuma inteligência sobre litígios ativos.

Para empresas que tomam decisões críticas com base nesses dados — aprovação de crédito, onboarding de parceiros, validação em plataformas de apostas ou compliance regulatório — esse nível de qualidade é insuficiente.

A API de Consulta CNPJ da Judit: Receita Federal em Tempo Real + Enriquecimento Judicial

A Judit oferece a API de consulta CNPJ de maior qualidade do mercado brasileiro. Ela conecta sua aplicação diretamente à Receita Federal — com opção de consulta on-demand em tempo real — e ainda agrega ao retorno dados autodeclarados pelas próprias empresas em processos judiciais.

Isso significa que, além dos dados oficiais, você recebe informações que as empresas declararam sob responsabilidade jurídica: endereços atualizados em petições, contatos informados em ações, representantes legais identificados em processos — dados que muitas vezes são mais precisos do que os registros desatualizados na Receita.

Como Fazer uma Consulta CNPJ via API da Judit

A integração é direta. A requisição é feita via POST para o endpoint /requests/create:

curl --location 'https://lawsuits.prod.judit.io/requests/create' \
--header 'Content-Type: application/json' \
--header 'api-key: <SUA-API-KEY>' \
--data '{
    "search": {
        "search_type": "cnpj",
        "search_key": "99.999.999/0001-99",
        "response_type": "entity"
    }
}'

Para consultar os dados em tempo real diretamente na Receita Federal (e não apenas no datalake da Judit), basta adicionar o parâmetro on-demand: true ao payload:

{
  "search": {
    "search_type": "cnpj",
    "search_key": "99.999.999/0001-99",
    "response_type": "entity"
  },
  "on-demand": true  // ← consulta ao vivo na Receita Federal
}

A API também suporta consultas por CPF e Nome, alterando o parâmetro search_type para "cpf" ou "name". Para revelar os documentos dos sócios sem máscara, inclua "reveal_partners_documents": true no payload.

Quais Dados Retornam na Consulta CNPJ?

A resposta da API é um objeto JSON rico e bem estruturado. Abaixo, todos os campos retornados organizados por categoria:

🏢 Identificação e Situação Cadastral

📍 Endereço e Contatos

👥 Quadro Societário

O array partners retorna todos os sócios com dados detalhados:

🏭 Atividades Econômicas (CNAEs)

O array branch_activities retorna todas as atividades econômicas da empresa:

⚖️ Natureza Jurídica

Exemplo Completo de Retorno: Consulta CNPJ via API Judit

{
  "has_lawsuits": true,          // ← empresa possui processos judiciais
  "request_id": "6e5a24f7-f874-4234-8acc",
  "response_data": [
    {
      "entity_type": "company",
      "main_document": "99.999.999/0001-99",
      "name": "EMPRESA EXEMPLO LTDA",
      "social_name": "EXEMPLO",
      "head_office": true,
      "revenue_service_active": true,
      "size": "MEDIA",
      "share_capital": 500000,
      "special_status": null,
      "addresses": [{
        "street": "AV. PAULISTA", "number": "1000",
        "neighborhood": "BELA VISTA",
        "city": "SAO PAULO", "state": "SP"
      }],
      "contacts": [
        { "description": "11999990000", "contact_type": "phone" },
        { "description": "contato@exemplo.com.br", "contact_type": "email" }
      ],
      "partners": [{
        "name": "MARIA OLIVEIRA",
        "position": "SOCIA ADMINISTRADORA",
        "tags": {
          "age_group": "Entre 41 a 50 anos",
          "start_date": "2015-03-10T00:00:00.000Z"
        }
      }],
      "branch_activities": [{
        "code": "6311900",
        "name": "TRATAMENTO DE DADOS E HOSPEDAGEM",
        "active": true,
        "main_activity": true
      }],
      "legal_nature": {
        "code": "2062",
        "name": "SOCIEDADE EMPRESARIA LIMITADA",
        "active": true
      }
    }
  ]
}

O Diferencial que Nenhuma Outra API Entrega: Enriquecimento por Dados Judiciais Autodeclarados

Quando uma empresa é parte em um processo judicial, ela — ou seus representantes — declara informações sob responsabilidade jurídica: endereço atualizado em petições, contatos utilizados em notificações, representantes legais identificados nos autos.

A Judit captura e processa esses dados de mais de 90 tribunais brasileiros e os agrega ao perfil cadastral de cada empresa. Na prática, isso significa que ao consultar um CNPJ pela API da Judit, você não está recebendo apenas o que a empresa declarou na abertura — você está recebendo o que ela declarou ontem em uma petição judicial.

Por que isso importa na prática?

Casos de Uso: Quem Usa a API de CNPJ da Judit e Para Quê

💳 Fintechs e Meios de Pagamento

Empresas como a RechargePay integram a API da Judit para validar cadastros PJ no onboarding com máxima confiabilidade — garantindo que o CNPJ consultado corresponde a uma empresa ativa, com dados corretos e sem histórico problemático.

🎲 Plataformas de Apostas Esportivas (Bets)

Com a regulamentação do mercado de apostas no Brasil, operadoras precisam validar cadastros com rigor crescente. A API da Judit entrega dados com qualidade suficiente para atender exigências de compliance, KYC/KYB e prevenção à lavagem de dinheiro — sendo a escolha de múltiplas plataformas do setor.

📊 Inteligência de Dados e Analytics

A Neoway, empresa do Grupo B3 — uma das maiores plataformas de inteligência de negócios do Brasil — utiliza os dados da Judit para enriquecer suas análises. Um indicativo claro do nível de qualidade e confiabilidade da fonte.

🏦 Crédito e Score Empresarial

Para concessão de crédito B2B, a combinação de dados cadastrais atualizados com o sinal de processos judiciais entrega uma visão de risco muito mais precisa do que bureaus convencionais baseados apenas na Receita Federal.

🔍 Compliance e Due Diligence

Escritórios de advocacia, fundos de investimento e empresas em processos de M&A utilizam a API para due diligence automatizada — verificando situação cadastral, quadro societário, CNAEs e exposição judicial em segundos.

Além do CNPJ: Consulta de Processos Judiciais da Empresa e dos Sócios

Se o enriquecimento cadastral já posiciona a Judit à frente, há um diferencial ainda mais estratégico: a mesma plataforma que consulta dados cadastrais também permite consultar os processos judiciais da empresa e dos seus sócios — individualmente.

Isso significa que, com um único fornecedor e uma única integração, você consegue:

• ✓ Dados cadastrais completos da empresa (Receita Federal + enriquecimento judicial)
• ✓ Situação cadastral em tempo real diretamente na Receita
• ✓ Quadro societário detalhado, com documentos revelados sob demanda
• ✓ Processos judiciais da empresa em qualquer tribunal do Brasil
• ✓ Processos judiciais dos sócios — visão de risco individual raramente disponível
• ✓ Indicador has_lawsuits já no retorno da consulta cadastral

Perguntas Frequentes sobre a API de Consulta CNPJ