Consulta de CNPJ é commodity. O CFO responde três perguntas sobre qualquer empresa — quem é, com quem se relaciona e o que o Estado registra sobre ela: dívida ativa, sanção, contrato público, marca, domínio, frota, obra, autuação ambiental. Não é um score. Cada sinal vem com a fonte oficial e a data da carga, para você auditar antes de decidir.
Base de referência agosto/2026 · recência de cada fonte em cfo.com.br/status
A maioria das APIs de CNPJ para na primeira. O valor de decisão — crédito, compliance, due diligence — está nas outras duas.
Razão social, nome fantasia, situação cadastral, endereço, CNAEs, natureza jurídica, capital, porte, Simples e MEI, regime tributário e o QSA completo.
As empresas ligadas por sócios em comum, em múltiplas direções e saltos — com os sinais de risco propagados pelos nós vizinhos como indício de relação, nunca como culpa transferida.
Negativos: dívida ativa da União e estadual, CEIS/CNEP, IBAMA, Lista Suja do trabalho escravo. Positivos: BNDES, FINEP, contratos no PNCP, marcas, aeronaves, supervisão do BCB.
Uma chamada devolve o dossiê inteiro: cadastro, endereço, CNAEs, Simples/MEI, regime
tributário, quadro societário e o bloco sinais com o que há de
positivo e de negativo sobre a empresa.
curl "https://consulta-cnpj-brasil1.p.rapidapi.com/v1/empresa?cnpj=33000167000101" \ -H "X-RapidAPI-Host: consulta-cnpj-brasil1.p.rapidapi.com" \ -H "X-RapidAPI-Key: SUA_CHAVE"
// trecho da resposta { "razao_social": "PETROLEO BRASILEIRO S A PETROBRAS", "situacao": "ATIVA", "sinais": { "filiais": 660, "marcas": { "total": 1023 }, "dominios": 60, "ibama": { "autuacoes": 3203 } }, "referencia": "2026-08" }
O dossiê mostra quantos — "dominios": 60,
"marcas": {…}. Os endpoints de seção mostram quais.
| Movimento | Endpoint | Para quê |
|---|---|---|
| 1 · Descobrir | GET /v1/empresas |
Encontrar empresas por filtro — UF, cidade, CNAE, capital, situação, data de abertura, texto livre |
| 2 · Aprofundar | GET /v1/empresa |
O dossiê completo de um CNPJ, com o bloco de sinais |
| 3 · Detalhar | 9 endpoints de seção |
A lista por trás de cada número do dossiê |
| 4 · Triar em lote | GET /v1/screening |
Até 10 CNPJs numa chamada, só com os sinais de risco |
| — Controlar | GET /v1/meta · /v1/ping |
Sua cota, seu uso no mês, a data de referência da base e o health check. Não consomem nada |
Todas aceitam ?cnpj= e &format=csv, devolvem até
50 mil linhas e não consomem cota — o acesso já foi pago pelo dossiê. Exigem apenas que você
tenha consultado aquele CNPJ nos últimos 30 dias.
| Endpoint | Devolve | Fonte |
|---|---|---|
/v1/dominios | Domínios .br da empresa: domínio, titular, registro, expiração, DNS, IP | Registro .br |
/v1/marcas | Marcas: processo, elemento nominativo, situação, classe, depósito | INPI |
/v1/contratos | Contratos com o poder público: vigência, valor global, objeto, órgão | PNCP |
/v1/grupo | Empresas ligadas por sócios em comum, ordenadas por quantos | Receita Federal |
/v1/filiais | Todos os estabelecimentos da raiz, com endereço e situação | Receita Federal |
/v1/veiculos | Frota habilitada para transporte rodoviário | ANTT |
/v1/obras | Obras registradas no Cadastro Nacional de Obras | CNO/RFB |
/v1/aeronaves | Aeronaves: matrícula, fabricante, modelo, gravames | ANAC/RAB |
/v1/ibama | Autuações e embargos ambientais, com multa e situação | IBAMA |
Além da cobrança por requisição do marketplace, o CFO tem réguas próprias — e informa o saldo de todas em headers de resposta, para você se controlar sem gastar uma chamada extra.
x-ratelimit-remaining: 99994 // buscas restantes no mês x-empresas-remaining: 49997 // dossiês restantes x-leads-remaining: 19998 // contatos que ainda pode revelar
/v1/meta e
/v1/ping não consomem nada.
reveal=1 a página traz até 25 linhas
(sem reveal, vai cheia); o screening aceita até 10 CNPJs por lote.
CNPJ 33.000.167/0001-01. Uma chamada de dossiê revela que esses registros
existem; uma chamada por seção revela quais são.
Agregador de dado público sensível, mal apresentado, vira difamação ou decisão errada. Estas três regras são de implementação, não de marketing — e valem tanto na API quanto na tela.
Todo sinal é um indício relacional, nunca um veredito. A linguagem é sempre relacional (“controladora com sanção vigente”, nunca “empresa sancionada”), e a propagação pelo grupo econômico descreve a relação — não transfere culpa de um nó para outro.
“Nada consta” não atesta idoneidade: significa que nada foi encontrado nas bases abertas na data da última carga. Onde a cobertura é parcial, o rótulo é explícito — a dívida ativa estadual cobre 9 UFs, e as outras 18 não estão na base.
O CFO não emite nota nem reputação. Ele lista fatos com origem e data; a interpretação é de quem consulta. O produto informa — quem julga é o humano com contexto.
Antes de filtrar por data, leia isto. A base de cadastro é a carga oficial da Receita Federal, que tem defasagem de algumas semanas na própria fonte — é assim para todo mundo.
O /v1/meta devolve abertura_recente, a abertura mais
nova que existe na base. Filtrar por uma janela mais curta que isso devolve lista vazia —
corretamente, não por erro. Para monitorar empresas novas, use uma janela de 30 dias ou mais.
Todas são bases públicas e auditáveis. A recência de cada uma é pública em cfo.com.br/status — que lê o mesmo registro de carga do monitoramento interno, então uma fonte atrasada aparece atrasada.
Formato único: { "error": { "code": "…", "message": "…" } },
com a mensagem em português explicando a saída.
| Código | HTTP | O que fazer |
|---|---|---|
not_consulted | 403 | Consulte o dossiê (/v1/empresa) desse CNPJ antes de pedir as seções |
quota_exceeded | 429 | Cota mensal de buscas esgotada — veja o header Retry-After |
empresa_quota_exceeded | 429 | Cota de dossiês esgotada; nada foi cobrado na chamada negada |
too_many_cnpjs | 400 | Lote acima de 10 CNPJs — divida |
filter_required | 400 | Período aberto (dias=0) exige ao menos um filtro seletivo |
bad_request | 400 | Parâmetro ausente ou malformado — a mensagem diz qual |
É o teste honesto: pegue uma empresa cuja história você já sabe e veja se o dossiê bate.
O /v1/ping não pede autenticação, e o /v1/meta
mostra sua cota sem consumir nada.