Identity lookup
CNPJ lookup
Official company registry data for a 14-digit CNPJ.
/openapi/v3/consultas/cnpj/{cnpj}token, timestamp and sign signature headers, see Authentication.Returns company registry data for a 14-digit corporate tax number: legal name, trade name, registration status, legal nature, CNAE activity code, registered address, contacts and share capital.
The response is a bare object with no platform envelope. The field table lists every possible field; when the source holds no data for a field it comes back empty, and such fields are left out of the example. GET request: the signed body is the empty string and the CNPJ is part of the signed path.
Path parameters
cnpj* | string | CNPJ |
* Required field
ni | string | CNPJ |
tipoEstabelecimento | string | Establishment type |
nomeEmpresarial | string | Legal name |
nomeFantasia | string | Trade name |
| object | Registration status |
| object | Legal nature |
dataAbertura | string | Incorporation date |
| object | Main CNAE |
| object | Registered address |
| object | Tax jurisdiction municipality |
| array | Phone numbers |
correioEletronico | string | E-mail address |
capitalSocial | number | Share capital |
porte | string | Company size code |
situacaoEspecial | string | Special status |
dataSituacaoEspecial | string | Special status date |
Format and check-digit errors (10016010, 10016011) are rejected locally by the platform: they consume no quota and are not billed. Authentication-layer errors (401 / 403 / 429) use the platform envelope; see the error model in Identity lookup.
tipoEstabelecimentoEstablishment type
| Values | Meaning |
|---|---|
| 1 | Headquarters |
| 2 | Branch |
situacaoCadastral.codigoRegistration status
| Values | Meaning |
|---|---|
| 1 | Void |
| 2 | Active |
| 3 | Suspended |
| 4 | Unfit |
| 8 | Closed |
| Code | HTTP | |
|---|---|---|
| 10016010 | 400 | Invalid CNPJ format (14 digits required). Check for stray formatting characters. |
| 10016011 | 400 | Invalid CNPJ check digits. Validate locally with the mod-11 algorithm first. |
| 10016012 | 400 | CNPJ not found. No such CNPJ in the official registry. |
| 10016020 | 503 | Upstream data source is temporarily unavailable. Retry with exponential backoff (start at 1 s, double up to 30 s, add jitter); contact the platform if it persists. |