Jurisdictions
Brazil
How to use Kausate in Brazil — what you can call, and which identifiers it uses
New to the API? Start with the jurisdictions overview, which explains how ordering, identifiers and documents work everywhere.
Operations
3 callable
Documents
None yet
Your own registry account
Not needed
Company data here comes directly from Cadastro Nacional da Pessoa JurÃdica (CNPJ).
What you can call here
What each operation does is the same everywhere and is explained on the jurisdictions overview.
| Operation | Status |
|---|---|
| Autocomplete | Live |
| Company search | Coming soon |
| Company report | Coming soon |
| Shareholder graph | Live |
| Prefill | Live |
How to search
Start with company search and jurisdictionCode: "br". Pass the name as companyName, a registration number as companyNumber, or both to narrow the result. Here companyNumber is read as cnpj.
Fields
To say exactly what you mean, send an advancedQuery instead. Brazil understands these fields:
| Field | What it does |
|---|---|
name | Company name to search for. |
cnpj | Cadastro Nacional da Pessoa JurÃdica (CNPJ) - Brazil’s 14-position national registry identifier for legal entities and establishments; the first 12 positions accept letters or digits and the final 2 positions are numeric check digits. Legacy all-numeric CNPJs remain valid. |
Examples
{ "jurisdictionCode": "br", "advancedQuery": { "name": "Petrobras" }}Brazil also accepts cnpj.
Company identifiers
Search by passing the registration number as companyNumber — it is matched against the schemes this register can search on, so you do not name the scheme yourself. Not every scheme below is searchable; the rest label the values returned in a company’s identifiers.
| Identifier | Appears as | Format |
|---|---|---|
| Brazilian CNPJ Cadastro Nacional da Pessoa JurÃdica (CNPJ) - Brazil’s 14-position national registry identifier for legal entities and establishments; the first 12 positions accept letters or digits and the final 2 positions are numeric check digits. Legacy all-numeric CNPJs remain valid. | br_cnpj | ^(?:[A-Z0-9]{12}\d{2}|[A-Z0-9]{2}\.[A-Z0-9]{3}\.[A-Z0-9]{3}/[A-Z0-9]{4}-\d{2})$ |
| Masked Brazilian CPF Brazilian CPF masked by the Receita Federal in the CNPJ open data's QSA block (e.g. **240659*); captured exactly as the register prints it | br_masked_cpf | No fixed format |
Identifier notes
- A Brazilian CNPJ is not one flat number. The first 8 digits identify the company itself; the next 4 digits identify one specific branch of it; the last 2 are check digits. The same company can hold many 14-digit CNPJs, one per branch, and they only share those first 8 digits — for example, Petrobras's headquarters CNPJ 33.000.167/0001-01 shares its first 8 digits with every other Petrobras branch CNPJ even though the full 14-digit numbers differ. If you need to know whether two CNPJs belong to the same underlying company rather than merely looking similar, compare the first 8 digits, not the full 14-digit number.
Local notes
Gotchas
| Trap | What happens |
|---|---|
| Company-level versus branch-level fields | Legal name, legal form and share capital are company-level and identical across all its CNPJs; status, trade name and address are branch-level and can differ between two CNPJs of the same company. |
| Address is city and state only | A company lookup's registered address includes only city and state — never street, number, or postal code. |
| Ownership is recorded per company | Ownership is recorded once per company, not per branch — the shareholder graph for any branch CNPJ returns the same partner list as the headquarters. |
| Non-owners in the partner list | The shareholder list also includes non-owners acting on someone else's behalf — attorney-in-fact, a minor partner's parent/guardian, consul, or notary. No ownership percentage is published; filter on interest-type to isolate real owners and officers. |
| Foreign parties land in description | For rare shareholder entries — usually foreign parties — the register doesn't state person or company; the name lands only in the description field, not the usual name fields, so code reading only those fields misses it. |
| Partner detail is free text | The register publishes a partner's start date, a foreign partner's country, a natural person's age bracket, and their legal representative's name, role and ID only as free text in the description field — parse it to get them. |
| Corporate partner CNPJ is the HQ | A corporate shareholder's identifiers, when present, point to that partner's headquarters CNPJ — not necessarily the branch CNPJ recorded in the ownership record. If it can't be matched, the entry still returns without identifiers. |
| Two suspensions normalize alike | Two status values that mean different things — a company temporarily suspended over a tax irregularity, and one declared unfit for failing to meet its tax filing obligations — both normalize to the same generic inactive status. If you need to tell these two situations apart, read the original register wording rather than the normalized status. |
| CNAE is not mapped | The activity code is Brazil's own CNAE classification with a Portuguese description — not mapped to ISIC, NACE, or any international scheme, so don't compare it directly against other jurisdictions' codes. |
Glossary
| Term | Meaning |
|---|---|
Ativa | The company's CNPJ registration is active and in good standing. |
Baixada | The CNPJ has been formally closed down / deregistered. |
Suspensa | The registration is temporarily suspended — for example, over a tax irregularity. |
Inapta | The registration has been declared unfit for failing to meet tax filing obligations, without being formally closed. |
Nula | The registration itself was declared null or void. |
Last updated on