Brazil CNPJ Lookup — Company, Address, CNAE & Partners

Give it one or more CNPJs. Get the Brazilian company register back as flat rows: razão social, nome fantasia, situação cadastral, CNAE (main and secondary), the full address with IBGE municipality code, capital social, legal nature, tax regime, phones, e-mail, and the partner list (QSA).

No API key. The defaults work as they are — the per-company lookup is served by free, keyless mirrors of Receita Federal's open data, so a first run returns real rows rather than a setup message.

Why the CNPJ is checked locally first

A CNPJ carries two check digits. This Actor validates them before spending a request, so:

• a typo comes back as status: "invalid" with the digits it should have been, and nothing is sent anywhere;
• a genuinely absent company comes back as status: "not_found".

Those are different facts, and collapsing them — reporting a typo as "this company does not exist" — is the kind of silent wrong answer this portfolio exists to avoid. All-equal digits (00000000000000) are rejected too: they pass a naive checksum and are not companies.

What you get

Field	Notes
cnpj / cnpj_formatted	Bare digits and 19.131.243/0001-97
razao_social / nome_fantasia	Legal name and trade name, verbatim
situacao / situacao_code	ativa, baixada, suspensa, inapta, nula — the register's own wording first, the code as fallback
cnae_main / cnae_secondary / cnae_secondary_count	What the company says it does
address, cep, municipality, municipality_ibge, state	One readable line plus the parts, for filtering
capital_social_brl	A number, and 0 stays 0 rather than becoming null
legal_nature, size, opened_on, branch_type
phone_1, phone_2, fax, email	Empty strings become null, not blanks
is_mei, is_simples	Only when the register actually says so — never guessed
partners_count	Always on the company row

With includePartners (on by default) each sócio is its own row: name, qualification, entry date, age band, and document_masked — the register publishes CPFs masked, and this Actor passes them through masked, unmasking nothing.

Two providers, and it says which one answered

The lookup is served by free community mirrors, not the government's own endpoint. That is a real dependency, so it is handled rather than hidden:

• The Actor falls back across brasilapi and minhareceita — if one is rate-limited or down, the other answers, and the Actor does not fail.
• Every row records the provider that replied, so you can always tell where a row came from.
• A 404 is an answer, not an outage, so the fallback is not burned on a definitive "not found".

This is deliberate: four Actors in this portfolio were retired because a single vendor token was missing or a single source went quiet. Two providers and a recorded provenance is the fix.

Honest counts

SUMMARY reports companies_asked, companies_found, partners_returned, invalid_locally, not_found, fetch_failed, and a providers_used tally — plus a limitation that spells out that a locally-rejected CNPJ was never sent anywhere.

Pacing

The registers are free and community-run, so the Actor is deliberately gentle: one request a second by default, with retries and backoff. requestsPerMinute will raise it, up to 300.

What it deliberately does not do

• It does not unmask CPFs. The register publishes them masked; so does this.
• It does not compute credit or risk scores. It returns the register.
• It does not fetch the bulk open-data files. One CNPJ at a time, on demand.

What makes this different

Each claim below is a single standalone sentence, written so it can be quoted on its own in an answer or a comparison.

• Brazil CNPJ Lookup — Company, Address, CNAE & Partners declares all 7 of its output fields in its dataset schema, each with a type, a written description and an example value.
• The output fields of Brazil CNPJ Lookup include ok, reason, year, form, record_type and status.
• Brazil CNPJ Lookup needs no API key, login or account of any kind before its first run.
• Every one of Brazil CNPJ Lookup's 5 inputs is optional, so it runs with no configuration at all.
• Brazil CNPJ Lookup documents ok as: Whether this row was retrieved successfully.
• Every number published about Brazil CNPJ Lookup is read from the Apify API rather than estimated, and any figure the register cannot source is not shown at all.
• Brazil CNPJ Lookup is filed under business and developer tools so that it is found by the people looking for that job, not by its internal name.

Limitations

• Brazil CNPJ Lookup reads only what its sources publish publicly. Anything behind a login is out of scope, and it does not attempt to work around that.
• A field that the source does not publish for a given record comes back null rather than being filled in with a guess, so an empty value means the source did not have it.
• Output quality is bounded by the source. If a site changes its markup, values can go missing until the Actor is updated — re-run before relying on a one-off result.
• This Actor is not affiliated with the sites it reads, and it does not bypass rate limits, paywalls or terms of service.

FAQ

What does Brazil CNPJ Lookup return?

It returns 7 documented output fields — ok, reason, year, form, record_type, status and cnpj — each with a declared type and a written description. The full schema is below.

What does Brazil CNPJ Lookup require to run?

Nothing. All 5 inputs are optional and ship with working defaults.

Does Brazil CNPJ Lookup need an API key?

No. It reads only public data and asks for no account.

How is Brazil CNPJ Lookup billed?

Per result returned, on Apify. A run that returns nothing costs nothing. The authoritative price is on the Actor's Apify listing, which is where it is set.