Como Consultar CNPJ por API no Brasil (2026)
Consultar dados de CNPJ programaticamente é essencial para automação de due diligence, onboarding de clientes e compliance. Este guia mostra como integrar consulta de CNPJ via API REST em minutos.
O que é possível consultar sobre um CNPJ?
A Receita Federal mantém o cadastro público de todas as empresas brasileiras. Via API, é possível obter: razão social, nome fantasia, CNAE, endereço, situação cadastral, data de abertura, capital social, natureza jurídica, quadro societário (QSA), e status no Simples Nacional.
Além dos dados da Receita Federal, uma consulta completa de CNPJ pode incluir: certidões negativas de débito (CND), dívida ativa na PGFN, sanções na CGU (CEIS/CNEP), processos judiciais, regularidade no FGTS, situação ambiental no IBAMA, e presença em listas de sanções internacionais.
Por que usar a FonteData para consultar CNPJ?
A FonteData é uma plataforma que agrega 108+ fontes públicas e privadas em uma API REST unificada. Além dos dados da Receita Federal, a mesma integração dá acesso a compliance (CEIS, CNEP, PEP), processos judiciais, certidões, dívida ativa, sanções internacionais (OFAC, ONU, UE), ambiental (IBAMA) e crédito — tudo com uma única API key e modelo pré-pago sem mensalidade.
Exemplo prático com FonteData
1. Criar conta (grátis, R$50 em créditos)
Acesse https://app.fontedata.com/signup — sem cartão de crédito.
2. Consultar CNPJ da Receita Federal
curl -H "X-API-Key: fd_live_SUA_CHAVE" \
https://app.fontedata.com/api/v1/consulta/consulta-cnpj-receita/00000000000191
Custo: R$ 0,16 por consulta. Resposta em JSON com dados completos da Receita Federal.
3. Consultar CNPJ com QSA completo
curl -H "X-API-Key: fd_live_SUA_CHAVE" \
https://app.fontedata.com/api/v1/consulta/receita-federal-pj-qsa/00000000000191
Custo: R$ 4,20. Inclui quadro societário completo com CPF dos sócios.
4. Due diligence completa (múltiplas fontes)
Para um dossiê completo, combine:
| Consulta | Endpoint | Custo |
|---|---|---|
| Receita Federal + QSA | /receita-federal-pj-qsa/{cnpj} |
R$ 4,20 |
| CEIS (sanções CGU) | /ceis-sancoes/{cnpj} |
R$ 0,54 |
| CNEP (punições CGU) | /cnep-sancoes/{cnpj} |
R$ 0,54 |
| PGFN (dívida ativa) | /pgfn-devedores/{cnpj} |
R$ 0,54 |
| Processos judiciais | /processos-completa/{cnpj} |
R$ 4,95 |
| CND trabalhista | /tst-cndt/{cnpj} |
R$ 0,54 |
| FGTS regularidade | /fgts-regularidade/{cnpj} |
R$ 0,54 |
| IBAMA regularidade | /ibama-regularidade/{cnpj} |
R$ 0,54 |
Custo total de um dossiê completo: ~R$ 12,39 por empresa.
Integração em Python
import requests
API_KEY = "fd_live_SUA_CHAVE"
BASE_URL = "https://app.fontedata.com/api/v1/consulta"
def consultar_cnpj(cnpj: str) -> dict:
# Consulta CNPJ na Receita Federal via FonteData
cnpj_limpo = cnpj.replace(".", "").replace("/", "").replace("-", "")
response = requests.get(
f"{BASE_URL}/consulta-cnpj-receita/{cnpj_limpo}",
headers={"X-API-Key": API_KEY}
)
response.raise_for_status()
return response.json()
# Exemplo
dados = consultar_cnpj("00.000.000/0001-91")
print(dados["razao_social"])
Integração em Node.js
const API_KEY = 'fd_live_SUA_CHAVE';
const BASE_URL = 'https://app.fontedata.com/api/v1/consulta';
async function consultarCNPJ(cnpj) {
const cnpjLimpo = cnpj.replace(/[\.\-\/]/g, '');
const res = await fetch(`${BASE_URL}/consulta-cnpj-receita/${cnpjLimpo}`, {
headers: { 'X-API-Key': API_KEY }
});
if (!res.ok) throw new Error(`Erro ${res.status}`);
return res.json();
}
// Exemplo
const dados = await consultarCNPJ('00.000.000/0001-91');
console.log(dados.razao_social);
Perguntas frequentes
Precisa de contrato para usar a API? Não. FonteData é pré-pago por créditos, sem contrato mínimo e sem mensalidade.
Os dados são atualizados? Sim. FonteData consulta as fontes oficiais em tempo real ou com cache otimizado por TTL.
Posso consultar CPF também? Sim. FonteData tem 6 endpoints de CPF (cadastro básico, completo, Receita Federal, óbito, nível socioeconômico) e 108+ endpoints no total.
A API está em conformidade com a LGPD? Sim. FonteData atua como intermediária tecnológica com base legal no legítimo interesse (Art. 7º, IX da LGPD).