Brazil CNPJ Lookup — Company, Address, CNAE & Partners
Look up any Brazilian company by CNPJ and get the Receita Federal register back as flat rows: razão social, situação cadastral, CNAE, full address, capital social, tax regime, phones and the partner list. No API key needed, and an invalid CNPJ is rejected locally rather than reported as missing.
Brazil CNPJ Lookup — Company, Address, CNAE & Partners returns 7 documented output fields, including ok, reason, year, form and record_type. Every field carries a declared type, a written description and an example value. 1 runs are recorded on Apify.
- 7
- Output fields
- 5
- Inputs
- 1
- Run
- 2026-10-16
- Last run
01 — output
What it returns
Every field the extractor writes to its dataset, with its type, a written description and an example value.
| Field | Type | What it holds | Example |
|---|---|---|---|
| ok | string | number | boolean | array | objectnull | Whether this row was retrieved successfully. | [] |
| reason | string | number | boolean | array | objectnull | Why this row carries its status. | matched |
| year | string | number | boolean | array | objectnull | Year as recorded for this row. | [] |
| form | string | number | boolean | array | objectnull | Form as recorded for this row. | [] |
| record_type | stringnull | What this row is — company or partner. | change |
| status | stringnull | Outcome recorded for this row. | ok |
| cnpj | string | number | boolean | array | objectnull | Cnpj as recorded for this row. | [] |
02 — sample
One record
Assembled from the example values declared on the schema above, not invented at render time.
{
"ok": "[]",
"reason": "matched",
"year": "[]",
"form": "[]",
"record_type": "change",
"status": "ok",
"cnpj": "[]"
}03 — input
What you give it
| Input | Type | Description |
|---|---|---|
| cnpjs | arrayoptional | One CNPJ per line, with or without punctuation (19.131.243/0001-97 or 19131243000197). The check digits are verified locally first, so a typo is reported as a typo instead of as a missing company. |
| includePartners | booleanoptional | ON by default: one extra row per partner (sócio) with their role, entry date and the register's masked document. Turn it off for company rows only. |
| maxItems | integeroptional | Hard limit on how many CNPJs are looked up. Enforced exactly, in the order you gave them. |
| requestsPerMinute | integeroptional | The registers are free and community-run, so this Actor is deliberately gentle. The default is one request a second. Raise it only if you know the service can take it. |
| retries | integeroptional | How many times a rate-limit or server error is retried, with backoff, before the next provider is tried. The Actor already falls back across two providers, so this is a second line of defence. |
04 — run
Run Brazil CNPJ Lookup on your own input
It runs in the cloud on Apify. Nothing to install, and you are billed per result returned rather than per attempt.
05 — questions
Asked before running it
7 of 7 fields described
- What does Brazil CNPJ Lookup — Company, Address, CNAE & Partners return?
- It returns 7 documented output fields: ok, reason, year, form, record_type, status and cnpj. Each field declares its type, a description of what it holds, and an example value.
- What input does Brazil CNPJ Lookup — Company, Address, CNAE & Partners take?
- All 5 inputs are optional and ship with usable defaults, so it runs as-is. They are listed with their types below.
- Does Brazil CNPJ Lookup — Company, Address, CNAE & Partners need an API key or login?
- No. None of its inputs is a credential, and it reads only public data. Nothing to sign up for before the first run.
- How do I run Brazil CNPJ Lookup — Company, Address, CNAE & Partners?
- It runs on Apify. Start it from its listing with the inputs above, or call the Apify API with the Actor's ID. Results land in a dataset you can export as JSON, CSV or Excel, or read through the Apify API into your own pipeline.