CFOdados de empresas do Brasil
API REST · 24 fontes oficiais

A base de empresas do Brasil, na sua API.

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.

69.523.303empresas
72.789.635estabelecimentos
24fontes oficiais
14endpoints

Base de referência agosto/2026 · recência de cada fonte em cfo.com.br/status

O que a API responde

Três perguntas sobre qualquer CNPJ

A maioria das APIs de CNPJ para na primeira. O valor de decisão — crédito, compliance, due diligence — está nas outras duas.

01 · Quem é

Cadastro e quadro societário

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.

02 · Com quem se relaciona

Grafo societário e grupo econômico

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.

03 · O que o Estado registra

Sinais de risco e de capacidade

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.

Integração

Comece em 30 segundos

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.

GET /v1/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"
}
Arquitetura

Quatro movimentos, do amplo ao específico

O dossiê mostra quantos"dominios": 60, "marcas": {…}. Os endpoints de seção mostram quais.

MovimentoEndpointPara quê
1 · DescobrirGET /v1/empresas Encontrar empresas por filtro — UF, cidade, CNAE, capital, situação, data de abertura, texto livre
2 · AprofundarGET /v1/empresa O dossiê completo de um CNPJ, com o bloco de sinais
3 · Detalhar9 endpoints de seção A lista por trás de cada número do dossiê
4 · Triar em loteGET /v1/screening Até 10 CNPJs numa chamada, só com os sinais de risco
— ControlarGET /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
Detalhe

A lista por trás do número

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.

EndpointDevolveFonte
/v1/dominiosDomínios .br da empresa: domínio, titular, registro, expiração, DNS, IPRegistro .br
/v1/marcasMarcas: processo, elemento nominativo, situação, classe, depósitoINPI
/v1/contratosContratos com o poder público: vigência, valor global, objeto, órgãoPNCP
/v1/grupoEmpresas ligadas por sócios em comum, ordenadas por quantosReceita Federal
/v1/filiaisTodos os estabelecimentos da raiz, com endereço e situaçãoReceita Federal
/v1/veiculosFrota habilitada para transporte rodoviárioANTT
/v1/obrasObras registradas no Cadastro Nacional de ObrasCNO/RFB
/v1/aeronavesAeronaves: matrícula, fabricante, modelo, gravamesANAC/RAB
/v1/ibamaAutuações e embargos ambientais, com multa e situaçãoIBAMA
Cota

O medidor que devolve saldo

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.

headers de resposta
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
Busca vazia não custa. Requisição que devolve 0 registros é estornada.
Reabrir dossiê no mesmo mês é grátis. Você paga pela empresa, não pela chamada — reprocessar a mesma carteira dentro do mês custa zero.
As 9 seções não consomem cota. E /v1/meta e /v1/ping não consomem nada.
Revelar o mesmo contato de novo é grátis por 30 dias.
No lote, CNPJ não encontrado não é cobrado. E se o saldo não cobrir o lote inteiro, nada é debitado: a chamada é negada por completo, para você dividir e repetir sem prejuízo.
Limites do marketplace. Com reveal=1 a página traz até 25 linhas (sem reveal, vai cheia); o screening aceita até 10 CNPJs por lote.
Exemplo real

Petrobras, na base de agosto/2026

CNPJ 33.000.167/0001-01. Uma chamada de dossiê revela que esses registros existem; uma chamada por seção revela quais são.

1.023marcas no INPI
3.203autuações ambientais
660filiais
60domínios .br
37empresas ligadas por sócios
2obras no CNO
1aeronave no RAB
24fontes cruzadas no dossiê
Contrato de honestidade

O que a API não faz

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.

Indício ≠ prova

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.

Ausência ≠ inexistência

“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.

Sem score, sem parecer

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.

Proveniência

As 24 fontes

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.

Cadastro CNPJ Receita Federal Dívida ativa da União PGFN Sanções CEIS/CNEP CGU Pessoas politicamente expostas CGU Dívida ativa estadual Procuradorias Regime tributário ECF Contratos e licitações PNCP Emendas parlamentares Câmara/Senado Convênios Transferegov Fornecedores federais SIASG Marcas INPI Contratos de tecnologia INPI Patentes, desenhos e software INPI Títulos minerários ANM Royalties da mineração ANM/CFEM Geração de energia ANEEL Estabelecimentos de saúde CNES/DataSUS Instituições autorizadas Banco Central Registro de contadores CFC Aeronaves ANAC/RAB Autuações ambientais IBAMA Empregadores autuados MTE Operações BNDES Projetos FINEP
Previsibilidade

Todo erro diz o que fazer

Formato único: { "error": { "code": "…", "message": "…" } }, com a mensagem em português explicando a saída.

CódigoHTTPO que fazer
not_consulted403Consulte o dossiê (/v1/empresa) desse CNPJ antes de pedir as seções
quota_exceeded429Cota mensal de buscas esgotada — veja o header Retry-After
empresa_quota_exceeded429Cota de dossiês esgotada; nada foi cobrado na chamada negada
too_many_cnpjs400Lote acima de 10 CNPJs — divida
filter_required400Período aberto (dias=0) exige ao menos um filtro seletivo
bad_request400Parâmetro ausente ou malformado — a mensagem diz qual

Teste com um CNPJ que você conhece

É 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.