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.

Kontrata ng source

Publisher: Receita Federal, Brazil
Saklaw: Published CNPJ legal-entity establishments.
Kahulugan ng tala: 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.
Tinatanggap na pattern: ^[0-9A-Z]{12}\d{2}$
Normalization: padStart:14:0
Bilang ng mga tala: one
Lisensya: Hindi pa nabeberipika ang pahintulot sa muling paggamit. Hindi lisensya sa muling paggamit ang pampublikong access.

Mga kilalang limitasyon

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

Kontrata ng source para sa mga agent · Dokumentasyon ng source

Kailangan ng authentication. Gumagamit ang REST request ng Latinfo api key. Idinaragdag ng console ang authorization header at hindi iniimbak ang key.

Mga parameter

cnpjstringpathkailangan

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

Example: 00000000000191

Halimbawa ng request

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

Mga tugon

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

Mga header ng tugon

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

Mga field ng tugon

cnpj string kailangan

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

razao_social string kailangan

Registered legal name.

situacao string kailangan

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

ATIVA · SUSPENSA · INAPTA · BAIXADA · NULA

Kahulugan ng mga value

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 kailangan

Published trade name; may be absent.

uf string kailangan

Two-letter Brazilian state code.

municipio string kailangan

Receita municipality code, not a municipality name.

cnae_principal string kailangan

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.