API de consulta de CNPJ
O endpoint de CNPJ retorna os dados públicos empresariais da Receita Federal (via BrasilAPI): razão social, nome fantasia, situação cadastral, natureza jurídica, porte, CNAE principal, endereço e o quadro societário (QSA). É a base para due diligence de fornecedores, compliance e validação de contrapartes.
Para que serve
- Due diligence e onboarding de fornecedores e parceiros.
- Compliance: verificar situação cadastral (ativa/baixada) antes de contratar.
- Enriquecimento de cadastro B2B com CNAE, porte e endereço oficial.
Requisição
Autentique com o header Authorization: Bearer — gere seu token no dashboard após ativar um plano.
curl -X POST "https://apiconsultas.xyz/api/v1/consultas/cnpj" \
-H "Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"cnpj":"19131243000197"}'const res = await fetch("https://apiconsultas.xyz/api/v1/consultas/cnpj", {
method: "POST",
headers: {
Authorization: "Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({"cnpj":"19131243000197"}),
});
const data = await res.json();<?php
$ch = curl_init("https://apiconsultas.xyz/api/v1/consultas/cnpj");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => '{"cnpj":"19131243000197"}',
]);
$data = json_decode(curl_exec($ch), true);Resposta (200)
Exemplo com valores ilustrativos. O nível de detalhe (dados completos ou mascarados) depende do seu plano.
{
"success": true,
"consulta_id": "CNPJ-19131243000197-…",
"tipo_consulta": "cnpj",
"query": {
"termo_mascarado": "19.***.***/****-**",
"finalidade": "due_diligence"
},
"resultado_count": 1,
"data_quality": {
"sources_used": 1,
"confidence_score": 95,
"has_company_links": true,
"has_address": true,
"has_contacts": true
},
"data": [
{
"empresa": {
"cnpj": "19131243000197",
"razao_social": "RAZÃO SOCIAL EXEMPLO LTDA",
"nome_fantasia": "NOME FANTASIA",
"situacao": "ATIVA",
"natureza_juridica": "Sociedade Empresária Limitada",
"porte": "DEMAIS",
"cnae_principal": "6204-0/00 — Consultoria em tecnologia da informação",
"data_abertura": "2013-10-03",
"capital_social": "R$ 1.000.000,00"
},
"localizacao": {
"cidade": "São Paulo",
"estado": "SP",
"cep": "01311-902"
},
"socios": [
{
"nome": "NOME DO SÓCIO",
"qualificacao": "Sócio-Administrador",
"entrada": "2013-10-03"
}
]
}
],
"audit": {
"logged": true,
"timestamp": "2026-07-01T12:00:00.000Z"
},
"message": "Consulta realizada com sucesso."
}Campos retornados
| Campo | Descrição |
|---|---|
| empresa.razao_social | Razão social registrada na Receita. |
| empresa.nome_fantasia | Nome fantasia, quando informado. |
| empresa.situacao | Situação cadastral (ex.: ATIVA, BAIXADA). |
| empresa.natureza_juridica / porte | Natureza jurídica e porte da empresa. |
| empresa.cnae_principal | CNAE fiscal principal com descrição. |
| empresa.data_abertura / capital_social | Data de abertura e capital social. |
| localizacao.enderecos_detalhados | Endereço oficial (logradouro, município, UF, CEP). |
| empresa.socios | Quadro societário (QSA): nome, qualificação e entrada. |
Perguntas frequentes
De onde vêm os dados de CNPJ?
Da base pública da Receita Federal, acessada via BrasilAPI. São dados abertos de pessoa jurídica — razão social, situação cadastral, CNAE, endereço e QSA.
O quadro societário (QSA) é retornado?
Sim, quando disponível na Receita. O campo empresa.socios traz nome, qualificação e data de entrada de cada sócio.
A consulta de CNPJ funciona no teste de R$ 10?
A consulta via dashboard está disponível durante o acesso ativo. A integração via API (token Bearer) é liberada nos planos Mensal, Semestral e Vitalício.
Endpoints relacionados
Integre consulta de cnpj hoje
Ative um plano a partir de R$ 10, gere seu token Bearer e comece a consultar em minutos. Consultas ilimitadas enquanto o plano estiver ativo.