Brazil CNPJ Company Data
Pricing
from $2.98 / 1,000 company rows
Brazil CNPJ Company Data
Brazil company data by CNPJ from the Receita Federal open data: legal name, status, size, share capital, CNAE activities, address, phones, Simples and MEI, and tax regime. Turn on partners for one row per partner (QSA). No API key.
Pricing
from $2.98 / 1,000 company rows
Rating
0.0
(0)
Developer
Mamba Labs
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
21 minutes ago
Last modified
Categories
Features
Share
Give it a list of CNPJs and get one row per Brazilian company from the Receita Federal open CNPJ data: legal and trade name, registration status, legal nature, company size, share capital, main and secondary CNAE activities, address, phones, email, Simples Nacional and MEI options, and the latest tax regime. Turn on partners for one more row per partner or administrator (QSA). You pay per company row and per partner row; a CNPJ that is not registered, an invalid value, and a repeat are free.
Features
- One row per company with 42 registry fields, the same columns on every row.
- CNPJs with or without punctuation (07.526.557/0001-00 or 07526557000100). An 8 digit root reads the head office (0001).
- Check digits are verified before any request, so a mistyped CNPJ is a free row, not a charge.
- Partners (QSA) are opt in: name, role, entry date, age range, partner company CNPJ, and legal representative.
- Up to 10,000 CNPJs per run, read 4 at a time.
How the data is read
Each CNPJ is one GET to Minha Receita (minhareceita.org), the open source public API that serves the Receita Federal open CNPJ data. Its public API takes no key and refuses no query for usage limits. Requests go through the Apify proxy pool. No login, no API key, no other developer's actor, and no browser.
Input
| Field | Type | Default | What it does |
|---|---|---|---|
cnpjs | array | CNPJs to look up, 14 digits with or without punctuation (07.526.557/0001-00 or 07526557000100). An 8 digit root reads the head office. Up to 10,000 per run. In Clay, put the column inside a one item list. | |
include_partners | string | false | true adds one row per partner or administrator (QSA), charged per partner. Default false. |
max_partners_per_company | string | 100 | Most partner rows per company, 1 to 1000. Default 100. |
dedupe | string | true | true (default) reads a CNPJ once per run even when it appears twice. The repeat is not charged. |
max_charge_usd | string | Optional. The run stops before a charge that would pass this amount. Summary rows are always returned. |
Output
| Field | Type | What it holds |
|---|---|---|
row_type | string | One of: company, partner, run_summary. run_summary is the one free row written when the input is refused. |
input_value | string | The CNPJ value from your input, as given. |
read_as_head_office | boolean | True when the input was an 8 digit CNPJ root, read as its head office (0001). |
cnpj | string | 14 digit CNPJ, digits only. |
cnpj_formatted | string | CNPJ as 00.000.000/0000-00. |
company_name | string | Razao social, the registered legal name. |
trade_name | string | Nome fantasia, when the company declared one. |
head_office_or_branch | string | MATRIZ (head office) or FILIAL (branch). |
registration_status | string | Situacao cadastral: ATIVA, BAIXADA, INAPTA, SUSPENSA, or NULA. |
registration_status_date | string | Date of the current registration status (YYYY-MM-DD). |
registration_status_reason | string | Reason for the registration status, as the registry describes it. |
special_status | string | Situacao especial, for example a judicial recovery, when the registry shows one. |
special_status_date | string | Date of the special status (YYYY-MM-DD). |
activity_start_date | string | Date the company started activity (YYYY-MM-DD). |
legal_nature | string | Natureza juridica, for example Sociedade Anonima Aberta or Sociedade Empresaria Limitada. |
legal_nature_code | string | Natureza juridica code. |
company_size | string | Porte: MICRO EMPRESA, EMPRESA DE PEQUENO PORTE, or DEMAIS. |
share_capital_brl | number | Capital social in Brazilian reais. |
main_cnae | string | Main activity CNAE code, 7 digits. |
main_cnae_description | string | Main activity description in Portuguese. |
secondary_cnaes | string | Secondary activities as code - description, joined with a semicolon. |
secondary_cnae_count | integer | Number of secondary activities. |
street | string | Street type and name. |
street_number | string | Street number as registered. |
address_complement | string | Floor, unit, or building. |
neighborhood | string | Bairro. |
city | string | Municipio. |
state | string | Two letter state code (UF). |
postal_code | string | CEP, 8 digits. |
city_ibge_code | string | IBGE municipality code. |
foreign_city | string | City abroad, for a company registered outside Brazil. |
foreign_country | string | Country, for a company registered outside Brazil. |
phone_1 | string | First registered phone with country code, as the registry publishes it. |
phone_2 | string | Second registered phone with country code. |
fax | string | Registered fax with country code. |
email | string | Registered company email, lowercased, when the registry publishes one. |
simples_option | boolean | True when the company opted into Simples Nacional, false when it did not, null when the registry has no record. |
simples_since | string | Date of the Simples Nacional option (YYYY-MM-DD). |
simples_until | string | Date the company left Simples Nacional (YYYY-MM-DD). |
mei_option | boolean | True when the company is a MEI (individual micro entrepreneur). |
mei_since | string | Date of the MEI option (YYYY-MM-DD). |
mei_until | string | Date the company left MEI (YYYY-MM-DD). |
tax_regime_latest | string | Forma de tributacao in the latest year on record, for example LUCRO REAL or LUCRO PRESUMIDO. |
tax_regime_year | integer | Year of the latest tax regime on record. |
partners_count | integer | Number of partners and administrators (QSA) on record. |
partner_name | string | Partner or administrator name as the registry publishes it. Partner rows only. |
partner_kind | string | person, company, or foreign. Partner rows only. |
partner_role | string | Qualificacao, for example Diretor, Socio-Administrador, or Presidente. |
partner_since | string | Date the partner entered the company (YYYY-MM-DD). |
partner_age_range | string | Age range the registry publishes for a person partner. |
partner_cnpj | string | CNPJ of a partner that is a company. Left empty for a person: the actor does not return CPF fragments. |
partner_country | string | Country of a foreign partner. |
legal_representative_name | string | Legal representative of the partner, when the registry names one. |
legal_representative_role | string | Role of the legal representative. |
row_status | string | ok, or why this row carries no data: no_results, no_change, partial, blocked, or error. |
error_reason | string | Why the row is not ok. A refused input reads input_invalid: followed by what to fix. |
billable_events_json | string | What this row was billed as, for example {"company-row":1}. {} means free. |
scraped_at | string | When the row was written, UTC. |
Pricing
Pay per event. You pay the run start and one charge per company row, plus one per partner row when you turn partners on. A CNPJ that is not registered, an invalid value, a repeat, a refused request, summaries, and a refused input are free.
| Event | Free plan | Bronze | Silver | Gold |
|---|---|---|---|---|
company-row, one company read from the CNPJ registry | $0.0035 | $0.003325 | $0.00315 | $0.002975 |
partner-row, one partner (QSA) of a company | $0.001 | $0.00095 | $0.0009 | $0.00085 |
apify-actor-start, once per run (one per GB of memory; the default 256 MB is one) | $0.005 | $0.005 | $0.005 | $0.005 |
Per 1,000 rows of company-row: $3.50 on the free plan, $2.98 on Gold.
Free plan cap: 1.50 USD of evaluation a month, about 429 rows. Any paid Apify plan removes the cap, and it resets on the 1st. The run stops before a charge that passes your maximum charge per run in Apify or your max_charge_usd input.
Mamba Labs pays the platform costs of your run, Apify proxy traffic included.
Usage examples
Check a supplier. {"cnpjs": ["07.526.557/0001-00"]} returns the company row with its status, activity, and address.
Map ownership. {"cnpjs": ["07526557000100", "33000167000101"], "include_partners": "true"} adds one row per partner and administrator.
Clay. Number and on or off inputs are text fields, which is what Clay sends. A list input takes a JSON list, so put the column inside a one item list.
MCP. The Mamba Labs MCP server @mambalabsdev/mcp-brazil-cnpj-company-data exposes this actor to Claude and other MCP clients.
Error handling
| Case | What you get |
|---|---|
| Missing or unreadable input | One free row, row_type run_summary, error_reason starting input_invalid: with what to fix. The run ends successfully and charges nothing but the run start |
| A value that is not a valid CNPJ in a list | One free company row with row_status error and input_invalid: in error_reason; the other CNPJs are read |
| A CNPJ that is not registered | One free company row with row_status no_results |
| The same CNPJ twice | Read and charged once; the repeat writes no row |
| The source refuses or fails a request | One free row with row_status blocked or error; no retry on another address |
| The first 5 CNPJs find nothing | The run stops with a free run_summary row, so a wrong list costs little |
| The run is close to its timeout | The actor stops starting new work 90 seconds before the timeout and delivers what it has |
Limitations
- Lookup by CNPJ only. The open data API has no company name search.
- The data is as fresh as the Receita Federal open data release that Minha Receita loaded, usually monthly. A change filed this week may not show yet.
- A person partner's CPF fragment is not returned. The registry publishes names, roles, entry dates, and age ranges only.
- For a MEI (individual micro entrepreneur) the legal name usually names the person, and the registry may list a personal phone or email. Use that data under Brazil's LGPD.
- Minha Receita states no service level. When it is slow or down, rows come back as free errors.
- Share capital is the declared capital in reais, not revenue.
Mamba Labs actor suite
Built by Mamba Labs.