English
EspañolEnglishPortuguêsFilipino
Get free API key
Brazil · br_receita_cnpj_cnpj
OpenAPI

Lookup receita · cnpj by CNPJ

GET https://api.latinfo.dev/br/receita/cnpj/cnpj/{cnpj}

An establishment, not necessarily the entire corporate group. Coverage: Published CNPJ legal-entity establishments. Lookup by cnpj as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below. Municipality values are Receita codes; resolve against the correct codebook before presenting names. Returns one record. Import time is not observation time; inspect freshness headers.

Source contract

Publisher
Receita Federal, Brazil
Coverage
Published CNPJ legal-entity establishments.
Record meaning
An establishment, not necessarily the entire corporate group.
Identifier
Lookup by cnpj as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Accepted pattern
^[0-9A-Z]{12}\d{2}$
Normalization
padStart:14:0
Cardinality
one
License
Reuse permission has not been verified. Public access is not a reuse license.

Known limitations

  • Municipality values are Receita codes; resolve against the correct codebook before presenting names.

Machine-readable source contract · Source documentation

Authentication required. REST requests use a Latinfo API key. The interactive console builds the authorization header and does not store the key.

Parameters

cnpjstringpathrequired

CNPJ in the source's normalized format. Keep identifiers as strings; preserve leading zeros.

Example: 00000000000191

Request example

curl https://api.latinfo.dev/br/receita/cnpj/cnpj/00000000000191 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Responses

200Published source records. Missing data is not a clearance or a negative finding.

Response headers

X-Latinfo-Imported-At

Import time, not the date of the government observation.

X-Source-Updated-At

Publisher update time, when known.

X-Latest-Observation-At

Latest date in returned records, when known.

X-Freshness-Status

string

CURRENT · DELAYED · STALE · UNKNOWN
X-Credits-Cost

Actual credits charged for this request.

X-Source-Generation

Opaque immutable source generation. Follow the guarded next-page Link when collecting a history.

Content-Type: application/json

Response fields

cnpj string required

Lookup by cnpj as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.

razao_social string required

Registered legal name.

situacao string required

Receita establishment status: ATIVA, BAIXADA, INAPTA, SUSPENSA or NULA.

ATIVA · SUSPENSA · INAPTA · BAIXADA · NULA

Value meanings

TAX_REGISTRATION

ATIVA

Active: Brazil's Federal Revenue reports the CNPJ registration as active.

SUSPENSA

Suspended: Brazil's Federal Revenue reports the CNPJ registration as suspended.

INAPTA

Declared unfit: Brazil's Federal Revenue reports the CNPJ registration as unfit because the entity did not satisfy applicable registration obligations.

BAIXADA

Deregistered: Brazil's Federal Revenue reports the CNPJ registration as deregistered.

NULA

Null registration: Brazil's Federal Revenue reports the CNPJ registration as null.

nome_fantasia string required

Published trade name; may be absent.

uf string required

Two-letter Brazilian state code.

municipio string required

Receita municipality code, not a municipality name.

cnae_principal string required

Principal CNAE activity code.

Response schema
{
  "type": "object",
  "properties": {
    "cnpj": {
      "type": "string",
      "description": "Lookup by cnpj as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below."
    },
    "razao_social": {
      "type": "string",
      "description": "Registered legal name.",
      "x-latinfo-meaning": "text"
    },
    "situacao": {
      "type": "string",
      "description": "Receita establishment status: ATIVA, BAIXADA, INAPTA, SUSPENSA or NULA.",
      "x-latinfo-meaning": "text",
      "enum": [
        "ATIVA",
        "SUSPENSA",
        "INAPTA",
        "BAIXADA",
        "NULA"
      ],
      "x-latinfo-vocabulary": {
        "id": "br.receita.tax_status.v1",
        "scope": "TAX_REGISTRATION",
        "empty_policy": "reject",
        "values": {
          "ATIVA": {
            "code": "ACTIVE",
            "label_en": "Active",
            "explanation_en": "Brazil's Federal Revenue reports the CNPJ registration as active."
          },
          "SUSPENSA": {
            "code": "SUSPENDED",
            "label_en": "Suspended",
            "explanation_en": "Brazil's Federal Revenue reports the CNPJ registration as suspended."
          },
          "INAPTA": {
            "code": "INACTIVE",
            "label_en": "Declared unfit",
            "explanation_en": "Brazil's Federal Revenue reports the CNPJ registration as unfit because the entity did not satisfy applicable registration obligations."
          },
          "BAIXADA": {
            "code": "CANCELLED",
            "label_en": "Deregistered",
            "explanation_en": "Brazil's Federal Revenue reports the CNPJ registration as deregistered."
          },
          "NULA": {
            "code": "CANCELLED",
            "label_en": "Null registration",
            "explanation_en": "Brazil's Federal Revenue reports the CNPJ registration as null."
          }
        }
      }
    },
    "nome_fantasia": {
      "type": "string",
      "description": "Published trade name; may be absent.",
      "x-latinfo-meaning": "text"
    },
    "uf": {
      "type": "string",
      "description": "Two-letter Brazilian state code.",
      "x-latinfo-meaning": "text"
    },
    "municipio": {
      "type": "string",
      "description": "Receita municipality code, not a municipality name.",
      "x-latinfo-meaning": "text"
    },
    "cnae_principal": {
      "type": "string",
      "description": "Principal CNAE activity code.",
      "x-latinfo-meaning": "code"
    }
  },
  "required": [
    "cnpj",
    "razao_social",
    "situacao",
    "nome_fantasia",
    "uf",
    "municipio",
    "cnae_principal"
  ],
  "additionalProperties": false
}
400Invalid identifier or query. Correct the input before retrying.
No response body documented.
401Missing or invalid API key. Authenticate before retrying.
No response body documented.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
No response body documented.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
No response body documented.
503Source unavailable. Report unavailable, not an empty result.
No response body documented.
Example JSON

Illustrative schema example. This is not a live response.

{
  "cnpj": "string",
  "razao_social": "string",
  "situacao": "ATIVA",
  "nome_fantasia": "string",
  "uf": "string",
  "municipio": "string",
  "cnae_principal": "string"
}

Provenance and limitations

Coverage varies by country and public source. A missing field is not evidence that the underlying fact does not exist. Public registries may be delayed or contain source errors; inspect the returned evidence and source date before relying on a result.

Esc