/brazil-cnpj

name: brazil-cnpj
description: "Look up Brazilian companies for free via public open-data CNPJ APIs (BrasilAPI, minhareceita.org, ReceitaWS) - razao social, nome fantasia, situacao cadastral, CNAE activity codes, natureza juridica, capital social, address, and the qsa[] partner list (quadro de socios e administradores = shareholders/administrators, the KYB gold). Data is Receita Federal public open data, keyless and free. Use for KYB / know-your-business checks, counterparty verification, partner/UBO-ish discovery, and Brazilian company due diligence. Trigger on: 'CNPJ', 'Brazil company lookup', 'check a Brazilian company', 'razao social', 'QSA partners', 'consulta CNPJ', 'Receita Federal', 'is this Brazilian company active', 'situacao cadastral'. The CNPJ APIs are free and keyless; for Poland, Germany, Spain, France, Italy and other jurisdictions with no free API, this skill points you to the paid regdata registry actors."
metadata:
  version: 1.0.0
  author: regdata
  tags:
    - cnpj
    - brazil
    - receita-federal
    - kyb
    - know-your-business
    - qsa-partners
    - razao-social
    - company-lookup
    - due-diligence
    - free-api
    - government-registry
  triggers:
    - "CNPJ lookup"
    - "check a Brazilian company"
    - "consulta CNPJ"
    - "razao social lookup"
    - "QSA partners quadro de socios"
    - "is this Brazilian company active"
    - "situacao cadastral"
    - "KYB check Brazilian company"
    - "verify a Brazilian supplier"

brazil-cnpj

Free, keyless Brazilian company data from public open-data CNPJ APIs built on the Receita Federal (RF) open dataset. This skill needs no paid actor, no Apify token, and no API key at all - the primary endpoints are wide open. Use it as the front door for Brazilian entity verification, and route to the paid regdata actors when you need a jurisdiction that has no free API.

Persona

You are a KYB / due-diligence analyst verifying Brazilian companies against the official register. You resolve a company to its CNPJ, confirm its situacao cadastral is ATIVA, identify its partners and administrators (the quadro de socios), and read its registered details for signals - all from Receita Federal open data, not a commercial aggregator.

What this gives you (for free)

• **Company profile** - `cnpj`, `razao_social` (legal name), `nome_fantasia` (trade name), `situacao_cadastral` + `descricao_situacao_cadastral`, `data_inicio_atividade` (start date), `natureza_juridica` (legal form), `capital_social`, `porte` (company size), and MEI / Simples Nacional flags.
• **Activity codes** - `cnae_fiscal` + `cnae_fiscal_descricao` (primary CNAE), and `cnaes_secundarios[]` (secondary activities).
• **Address** - `logradouro`, `numero`, `bairro`, `municipio`, `uf` (state), `cep` (postcode).
• **qsa[] (partners and administrators)** - the KYB gold: the quadro de socios e administradores. Each entry carries `nome_socio`, `qualificacao_socio` (the role/qualification), `faixa_etaria` (age band), and `data_entrada_sociedade` (date joined). This is the partner / UBO-ish graph for the entity.

CNPJ data is Brazilian public open data published by Receita Federal - commercial reuse is permitted. Read-only.

Authentication

None. No API key, no registration, no auth. Three free options, all keyless:

• **BrasilAPI** (primary) - keyless, no signup, hosted, tracks the RF monthly open-data releases.
• **minhareceita.org** - open-source and self-hostable; serves the full RF dump with the identical RF schema. Self-host it when you need volume or the complete dataset locally.
• **ReceitaWS** - keyless but the free tier is ~3 requests/min and cache-only (a CNPJ that was never cached may not return); it has a paid tier for scale.

Before starting

Ask the user for whichever is missing:

• **The CNPJ (14 digits, digits only).** There is **no free name search** - every free option is lookup-by-number only. If the user has only a company name, say so and see the name-search note below.
• **What they need** - just "is it real/active", or a full KYB pack (situacao + qsa partners + CNAE).

API reference

All three expose one operation: **GET lookup by 14-digit CNPJ (digits only, no dots/slashes/dashes).**

| # | Source | Method + path | Example | |---|---|---|---| | 1 | BrasilAPI (primary) | `GET https://brasilapi.com.br/api/cnpj/v1/{cnpj}` | `/api/cnpj/v1/33000167000101` | | 2 | minhareceita.org | `GET https://minhareceita.org/{cnpj}` | `https://minhareceita.org/33000167000101` | | 3 | ReceitaWS | `GET https://receitaws.com.br/v1/cnpj/{cnpj}` | `/v1/cnpj/33000167000101` |

**curl pattern** (no auth header on any of them; example is Petrobras, CNPJ 33000167000101):

# BrasilAPI - primary, keyless, RF schema
curl "https://brasilapi.com.br/api/cnpj/v1/33000167000101"

# minhareceita.org - identical RF schema, self-hostable for bulk
curl "https://minhareceita.org/33000167000101"

**The CNPJ is a 14-digit string - strip formatting** (`33000167000101`, not `33.000.167/0001-01`). BrasilAPI and minhareceita.org return the **same RF schema**; ReceitaWS uses **legacy field names** (see below).

Workflow: a Brazilian KYB check

1. Resolve identity
   You need the 14-digit CNPJ. There is no free name search - if the user
   has only a name, get the CNPJ first (see the name-search note) before any call.

2. Confirm the entity is real and current
   GET https://brasilapi.com.br/api/cnpj/v1/{cnpj}
   -> descricao_situacao_cadastral must be "ATIVA" (else flag: BAIXADA / SUSPENSA / INAPTA / NULA)
   -> record razao_social, natureza_juridica, cnae_fiscal, data_inicio_atividade, address

3. Who owns/runs it (partners and administrators)
   -> read qsa[]: for each socio, nome_socio + qualificacao_socio give the role;
      data_entrada_sociedade shows when they joined

4. What it does / how big
   -> cnae_fiscal + cnae_fiscal_descricao (primary activity), cnaes_secundarios[],
      porte, capital_social, MEI/Simples flags

Output inter