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.

Contrato de la fuente

Publicador: Receita Federal, Brazil
Cobertura: Published CNPJ legal-entity establishments.
Qué representa un registro: An establishment, not necessarily the entire corporate group.
Identificador: Lookup by cnpj as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Patrón admitido: ^[0-9A-Z]{12}\d{2}$
Normalización: padStart:14:0
Cantidad de registros: one
Licencia: No se ha verificado el permiso de reutilización. El acceso público no equivale a una licencia de reutilización.

Limitaciones conocidas

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

Contrato de la fuente para agentes · Documentación de la fuente

Requiere autenticación. Las solicitudes REST usan una clave de api de Latinfo. La consola agrega el encabezado de autorización y no guarda la clave.

Parámetros

cnpjstringpathobligatorio

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

Example: 00000000000191

Ejemplo de solicitud

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

Respuestas

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

Encabezados de la respuesta

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

Campos de la respuesta

cnpj string obligatorio

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

razao_social string obligatorio

Registered legal name.

situacao string obligatorio

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

ATIVA · SUSPENSA · INAPTA · BAIXADA · NULA

Significado de los valores

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 obligatorio

Published trade name; may be absent.

uf string obligatorio

Two-letter Brazilian state code.

municipio string obligatorio

Receita municipality code, not a municipality name.

cnae_principal string obligatorio

Principal CNAE activity code.

Esquema de respuesta

{
  "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.