Lookup rns · sociedades by CUIT

GET https://api.latinfo.dev/ar/rns/sociedades/cuit/{cuit}

A registered company with fiscal/legal geography and principal economic activity. Coverage: Registered corporate CUITs in the published national companies snapshot. Lookup by cuit as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below. AC/BD describes economic activity, not the legal existence or solvency of the company. Returns one record. Import time is not observation time; inspect freshness headers.

Contrato da fonte

Publicador: Ministerio de Justicia, Argentina
Cobertura: Registered corporate CUITs in the published national companies snapshot.
Significado do registro: A registered company with fiscal/legal geography and principal economic activity.
Identificador: Lookup by cuit as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Padrão aceito: ^(30|33|34)\d{9}$
Quantidade de registros: one
Licença: CC BY 4.0

Limitações conhecidas

AC/BD describes economic activity, not the legal existence or solvency of the company.

Contrato da fonte para agentes · Documentação da fonte

Autenticação necessária. As requisições REST usam uma chave de api do Latinfo. O console adiciona o cabeçalho de autorização e não armazena a chave.

Parâmetros

cuitstringpathobrigatório

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

Example: 30500000127

Exemplo de requisição

curl https://api.latinfo.dev/ar/rns/sociedades/cuit/30500000127 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Respostas

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

Cabeçalhos da resposta

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 da resposta

cuit string obrigatório

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

razon_social string obrigatório

Registered legal name.

estado string obrigatório

Principal activity status: AC means active, BD means definitive deregistration; not legal company status.

AC · BD

Significado dos valores

ACTIVITY

AC

Active activity: ARCA reports the selected economic activity as active. This is not a legal-entity status.

BD

Activity definitively deregistered: ARCA reports the selected economic activity as definitively deregistered. This is not a legal-entity status.

tipo_societario string obrigatório

Registered legal form.

fecha_contrato string obrigatório

Published fecha contrato date. Format: YYYY-MM-DD-HH:mm.

fecha_actualizacion string obrigatório

Published fecha actualizacion date. Format: YYYY-MM-DD-HH:mm.

provincia_fiscal string obrigatório

Province of the fiscal address.

localidad_fiscal string obrigatório

Locality of the fiscal address.

domicilio_fiscal string obrigatório

Street and number of the fiscal address.

cp_fiscal string obrigatório

Fiscal postal code; retain leading zeros.

provincia_legal string obrigatório

Province of the registered address.

localidad_legal string obrigatório

Locality of the registered address.

actividad_codigo string obrigatório

Published principal economic-activity code.

actividad_descripcion string obrigatório

Published principal economic-activity description.

Esquema de resposta

{
  "type": "object",
  "properties": {
    "cuit": {
      "type": "string",
      "description": "Lookup by cuit as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below."
    },
    "razon_social": {
      "type": "string",
      "description": "Registered legal name.",
      "x-latinfo-meaning": "text"
    },
    "estado": {
      "type": "string",
      "description": "Principal activity status: AC means active, BD means definitive deregistration; not legal company status.",
      "x-latinfo-meaning": "text",
      "enum": [
        "AC",
        "BD"
      ],
      "x-latinfo-vocabulary": {
        "id": "ar.rns.activity_status.v1",
        "scope": "ACTIVITY",
        "empty_policy": "map_to_unknown",
        "values": {
          "AC": {
            "code": "ACTIVE",
            "label_en": "Active activity",
            "explanation_en": "ARCA reports the selected economic activity as active. This is not a legal-entity status."
          },
          "BD": {
            "code": "CANCELLED",
            "label_en": "Activity definitively deregistered",
            "explanation_en": "ARCA reports the selected economic activity as definitively deregistered. This is not a legal-entity status."
          }
        }
      }
    },
    "tipo_societario": {
      "type": "string",
      "description": "Registered legal form.",
      "x-latinfo-meaning": "text"
    },
    "fecha_contrato": {
      "type": "string",
      "description": "Published fecha contrato date. Format: YYYY-MM-DD-HH:mm.",
      "x-latinfo-meaning": "date"
    },
    "fecha_actualizacion": {
      "type": "string",
      "description": "Published fecha actualizacion date. Format: YYYY-MM-DD-HH:mm.",
      "x-latinfo-meaning": "date"
    },
    "provincia_fiscal": {
      "type": "string",
      "description": "Province of the fiscal address.",
      "x-latinfo-meaning": "text"
    },
    "localidad_fiscal": {
      "type": "string",
      "description": "Locality of the fiscal address.",
      "x-latinfo-meaning": "text"
    },
    "domicilio_fiscal": {
      "type": "string",
      "description": "Street and number of the fiscal address.",
      "x-latinfo-meaning": "text"
    },
    "cp_fiscal": {
      "type": "string",
      "description": "Fiscal postal code; retain leading zeros.",
      "x-latinfo-meaning": "code"
    },
    "provincia_legal": {
      "type": "string",
      "description": "Province of the registered address.",
      "x-latinfo-meaning": "text"
    },
    "localidad_legal": {
      "type": "string",
      "description": "Locality of the registered address.",
      "x-latinfo-meaning": "text"
    },
    "actividad_codigo": {
      "type": "string",
      "description": "Published principal economic-activity code.",
      "x-latinfo-meaning": "code"
    },
    "actividad_descripcion": {
      "type": "string",
      "description": "Published principal economic-activity description.",
      "x-latinfo-meaning": "text"
    }
  },
  "required": [
    "cuit",
    "razon_social",
    "estado",
    "tipo_societario",
    "fecha_contrato",
    "fecha_actualizacion",
    "provincia_fiscal",
    "localidad_fiscal",
    "domicilio_fiscal",
    "cp_fiscal",
    "provincia_legal",
    "localidad_legal",
    "actividad_codigo",
    "actividad_descripcion"
  ],
  "additionalProperties": false
}

400Invalid identifier or query. Correct the input before retrying.