Brazil Government Contracts Check - CNPJ

🏛️ What is Government Contracts Check?

Government Contracts Check finds active and historical federal procurement contracts for Brazilian companies by CNPJ or CPF. Paste up to 1,000 documents per run, export to JSON, CSV, Excel or XML, or call the REST API in real time.

One document in = one result out. Get company identity, aggregated stats (totals, active contracts, sum of values) and the full contract list with agency hierarchy, vigency dates and amounts. Invalid check digits are flagged locally.

What data can Government Contracts Check extract?

🏢 Company	razaoSocial, nomeFantasia, classificacao
📊 Statistics	quantidade, quantidadeAtivos, somaValorAssinatura, somaValorAtualizado
📄 Contract	codigoContrato, descricao, modalidade, situacao, processo
📅 Dates	assinaturaEm, publicacaoEm, vigenciaInicio, vigenciaFim, ativo
💰 Values	valorAssinatura, valorAtualizado (BRL floats)
🏛️ Agency	ministerio, entidade, unidade, poder, CNPJ and codes
🔑 Reference	Opaque referencia (bd-...) per contract for safe storage
🕐 Metadata	consultadoEm, truncado, paginasConsultadas

What can this Actor do?

• 📋 Bulk screening: up to 1,000 CNPJs/CPFs per run
• ✅ Local validation: invalid documents flagged before lookup
• 📤 Multiple exports: JSON, CSV, Excel, XML from Apify Dataset
• ⚡ Standby REST API: POST /check for real-time integration
• 📏 Payload control: maxContratosPorCnpj (1-500, default 50)
• 🔗 Pipeline-ready: pair with Sanctions, KYC, Enrichment and Tenders actors

Apify platform bonus: schedule recurring supplier checks, monitor runs, webhooks, API access and MCP integration.

---

Why check Brazilian government contracts by CNPJ?

• Supplier vetting: confirm federal contract history before onboarding vendors
• KYC/KYB compliance: verify public revenue exposure and contracting agencies
• Due diligence: assess concentration of government revenue before partnerships
• Market intelligence: identify active vendors to the Brazilian federal government
• Audit trails: stable references and timestamps per query

Official public data under Lei 12.527/2011 and aligned with Lei 14.133/2021 (PNCP). Federal Government Procurement Portal. No API key required.

---

How do I check government contracts in bulk?

1. Open the actor on Apify Console and go to the Input tab.
2. Paste CNPJs or CPFs in the cnpjs string list (any format).
3. Optional: set maxContratosPorCnpj (default 50) to control payload size.
4. Click Start, then export Dataset as XLSX, CSV or JSON.

Example input:

{
  "cnpjs": ["33.000.167/0001-01", "02.341.470/0001-44"],
  "maxContratosPorCnpj": 50
}

Tip: use maxContratosPorCnpj: 5 for quick screening; raise to 500 for large suppliers with many contracts.

---

⬇️ Input

Click the Input tab for the full schema.

Field	Required	Default	Description
cnpjs	✅ Yes	-	CNPJs or CPFs (string list). Max 1,000. Any format.
maxContratosPorCnpj	No	50	Cap on contracts returned per document (1-500).

---

⬆️ Output

Download from Dataset tab. One record per document queried.

Abbreviated sample. Full output includes all vinculos[] fields and nested contratante hierarchy. See Dataset schema for the complete list.

Also returned (not shown in sample): all contracts up to maxContratosPorCnpj, full agency codes, truncado flag when pagination limit is hit.

{
  "documento": "02341470000144",
  "documentoFormatado": "02.341.470/0001-44",
  "documentoValido": true,
  "encontrado": true,
  "empresa": {
    "razaoSocial": "RORAIMA ENERGIA S.A",
    "nomeFantasia": "RORAIMA ENERGIA S.A",
    "classificacao": "Entidades Empresariais Privadas"
  },
  "estatisticas": {
    "quantidade": 15,
    "quantidadeAtivos": 4,
    "somaValorAssinatura": 1234567.89,
    "somaValorAtualizado": 2987654.32,
    "dataMaisAntiga": "2008-12-31",
    "dataMaisRecente": "2020-12-14"
  },
  "vinculos": [
    {
      "referencia": "bd-7c1f9e3a2b5d",
      "codigoContrato": "001422020",
      "descricao": "PRESTACAO E UTILIZACAO DO SERVICO PUBLICO DE ENERGIA ELETRICA...",
      "ativo": false,
      "valorAssinatura": 38113.08,
      "valorAtualizado": 38113.08,
      "contratante": {
        "ministerio": "Ministerio das Comunicacoes",
        "entidade": "Agencia Nacional de Telecomunicacoes",
        "entidadeSigla": "ANATEL"
      }
    }
  ],
  "truncado": false,
  "consultadoEm": "2026-05-23T22:10:00.000Z"
}

Complete field list: Dataset schema tab on Apify Console.

---

How much does government contract screening cost?

$0.002 per document processed (CNPJ or CPF). Charged per document queried, with or without contracts found.

Volume	Cost
10 documents	$0.02
100 documents	$0.20
1,000 documents	$2.00

Use maxContratosPorCnpj to control payload size, not billing (current pricing is per document).

---

🔌 API integration

Batch run:

curl -X POST "https://api.apify.com/v2/acts/brasildados~government-contracts-check/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"cnpjs":["33.000.167/0001-01","02.341.470/0001-44"],"maxContratosPorCnpj":50}'

Standby (POST /check):

curl -X POST "https://brasildados--government-contracts-check.apify.actor/check" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  --compressed \
  -d '{"cnpjs":["33.000.167/0001-01"],"maxContratosPorCnpj":50}'

---

Related Actors

Actor	When to use
CNPJ Enrichment	Company profile, QSA and address for identified suppliers
Public Tenders	Find open tenders and bidding opportunities
Sanctions Check	CEIS/CNEP screening (sanctioned vendors cannot contract)
CNPJ KYC & PEP Checker	Full PEP, sanctions and electoral donations
DOU Monitor	Track contract publications in the Official Gazette

Suggested pipeline: Enrichment → Contracts (this) → Sanctions → KYC

---

FAQ

Can I query CPFs as well as CNPJs?

Yes. Send CPFs in the same cnpjs list. Any format accepted.

What if a company has hundreds of contracts?

Set maxContratosPorCnpj up to 500. Check truncado: true if more contracts exist beyond the limit.

Are only active contracts returned?

No. Both active and historical contracts are returned. Use estatisticas.quantidadeAtivos or filter vinculos[].ativo.

How recent is the data?

Continuously updated from official federal procurement databases. Typical lag varies by agency.

Is it legal to use this data?

Yes. Public procurement data under Lei 12.527/2011 and Lei 14.133/2021.

---

🇧🇷 Versão em português (Brasil)

🏛️ O que é a Consulta de Contratos Federais?

Consulta de Contratos Federais busca contratos ativos e históricos de empresas brasileiras por CNPJ ou CPF na administração pública federal. Cole até 1.000 documentos por execução, exporte em JSON, CSV, Excel ou XML, ou integre via API REST em tempo real.

1 documento na entrada = 1 resultado na saída. Identificação da empresa, estatísticas agregadas (totais, contratos ativos, soma de valores) e lista completa de contratos com hierarquia de órgãos, datas de vigência e valores. Dígitos inválidos são sinalizados localmente.

Quais dados a consulta de contratos federais retorna?

🏢 Empresa	razaoSocial, nomeFantasia, classificacao
📊 Estatísticas	quantidade, quantidadeAtivos, somaValorAssinatura, somaValorAtualizado
📄 Contrato	codigoContrato, descricao, modalidade, situacao, processo
📅 Datas	assinaturaEm, publicacaoEm, vigenciaInicio, vigenciaFim, ativo
💰 Valores	valorAssinatura, valorAtualizado (floats em BRL)
🏛️ Órgão	ministerio, entidade, unidade, poder, CNPJ e códigos
🔑 Referência	referencia opaca (bd-...) por contrato
🕐 Metadados	consultadoEm, truncado, paginasConsultadas

O que este Actor faz?

• 📋 Triagem em lote: até 1.000 CNPJs/CPFs por execução
• ✅ Validação local: documentos inválidos sinalizados antes da consulta
• 📤 Exportação múltipla: JSON, CSV, Excel, XML no Dataset Apify
• ⚡ API REST Standby: POST /check para integração em tempo real
• 📏 Controle de payload: maxContratosPorCnpj (1-500, padrão 50)
• 🔗 Pipeline: combine com Sanctions, KYC, Enriquecimento e Editais

Bônus Apify: agende verificações recorrentes, monitore execuções, webhooks, API e integração MCP.

---

Por que consultar contratos do governo federal por CNPJ?

• Homologação de fornecedores: confirme histórico de contratos federais antes de cadastrar
• Compliance KYC/KYB: verifique exposição a receita pública e órgãos contratantes
• Due diligence: avalie concentração de receita governamental antes de parcerias
• Inteligência de mercado: identifique fornecedores ativos do governo federal brasileiro
• Trilha de auditoria: referências estáveis e timestamps por consulta

Dados públicos oficiais sob Lei 12.527/2011, alinhados à Lei 14.133/2021 (PNCP). Portal de Compras do Governo Federal. Sem chave de API.

---

Como consultar contratos federais por CNPJ em lote?

1. Abra o actor no Console Apify e vá na aba Input.
2. Cole CNPJs ou CPFs na lista de strings cnpjs (qualquer formato).
3. Opcional: defina maxContratosPorCnpj (padrão 50) para controlar o tamanho da resposta.
4. Clique em Start e exporte o Dataset em XLSX, CSV ou JSON.

Dica: use maxContratosPorCnpj: 5 para triagem rápida; aumente até 500 para grandes fornecedores.

---

⬇️ Entrada

Clique na aba Input para o schema completo.

Campo	Obrigatório	Padrão	Descrição
cnpjs	✅ Sim	-	CNPJs ou CPFs (lista). Máx. 1.000. Qualquer formato.
maxContratosPorCnpj	Não	50	Limite de contratos por documento (1-500).

---

⬆️ Saída

Baixe na aba Dataset. Um registro por documento consultado.

Amostra resumida. A saída completa inclui todos os campos de vinculos[] e hierarquia contratante. Veja Dataset schema para a lista completa.

---

Quanto custa consultar contratos federais por CNPJ?

$0,002 por documento processado (CNPJ ou CPF). Cobrado por documento consultado, com ou sem contratos encontrados.

Volume	Custo
10 documentos	$0,02
100 documentos	$0,20
1.000 documentos	$2,00

Use maxContratosPorCnpj para controlar o tamanho da resposta, não a cobrança (preço atual é por documento).

---

🔌 Integração via API

Mesmos endpoints da seção em inglês acima. Substitua YOUR_TOKEN / YOUR_APIFY_TOKEN pelo seu token Apify.

---

Actors relacionados

Actor	Quando usar
Enriquecimento CNPJ	Perfil, QSA e endereço de fornecedores identificados
Editais e Licitações	Encontrar licitações abertas e oportunidades
Sanctions Check	Triagem CEIS/CNEP (fornecedores sancionados não podem contratar)
KYC & PEP Checker	PEP, sanções e doações eleitorais
Monitor DOU	Acompanhar publicações no Diário Oficial

Pipeline sugerido: Enriquecimento → Contratos (este) → Sanctions → KYC

---

Perguntas frequentes

Posso consultar CPF além de CNPJ?

Sim. Envie CPFs na mesma lista cnpjs. Qualquer formato aceito.

E se a empresa tiver centenas de contratos?

Defina maxContratosPorCnpj até 500. Verifique truncado: true se existirem mais contratos além do limite.

Retorna só contratos ativos?

Não. Retorna ativos e históricos. Use estatisticas.quantidadeAtivos ou filtre vinculos[].ativo.

Quão recentes são os dados?

Atualização contínua a partir de bases oficiais de compras federais. Defasagem típica varia por órgão.

É legal usar esses dados?

Sim. Dados públicos de licitações e contratos sob Lei 12.527/2011 e Lei 14.133/2021.