Lookup osce · entidades by RUC

GET https://api.latinfo.dev/pe/osce/entidades/ruc/{ruc}

A public buyer registration with administrative geography and internal codes. Coverage: Public contracting entities in the published OSCE directory. Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below. Directory inclusion is not evidence of a specific procurement award. Returns one record. Import time is not observation time; inspect freshness headers.

Contrato de la fuente

Publicador: OSCE / OECE, Peru
Cobertura: Public contracting entities in the published OSCE directory.
Qué representa un registro: A public buyer registration with administrative geography and internal codes.
Identificador: Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Patrón admitido: ^\d{11}$
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

Directory inclusion is not evidence of a specific procurement award.

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

rucstringpathobligatorio

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

Example: 20290898685

Ejemplo de solicitud

curl https://api.latinfo.dev/pe/osce/entidades/ruc/20290898685 \
  -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

ruc string obligatorio

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

nombre string obligatorio

Published entity name.

departamento string obligatorio

Published department name.

provincia string obligatorio

Published province name.

distrito string obligatorio

Published district name.

codigo_siaf string obligatorio

SIAF entity code; retain leading zeros.

codigo_consucode string obligatorio

OSCE internal entity code.

estado string obligatorio

Publisher status; interpret in the context of this dataset.

ultima_actualizacion string obligatorio

Published ultima actualizacion date. Format: DD/MM/YY.

Esquema de respuesta

{
  "type": "object",
  "properties": {
    "ruc": {
      "type": "string",
      "description": "Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below."
    },
    "nombre": {
      "type": "string",
      "description": "Published entity name.",
      "x-latinfo-meaning": "text"
    },
    "departamento": {
      "type": "string",
      "description": "Published department name.",
      "x-latinfo-meaning": "text"
    },
    "provincia": {
      "type": "string",
      "description": "Published province name.",
      "x-latinfo-meaning": "text"
    },
    "distrito": {
      "type": "string",
      "description": "Published district name.",
      "x-latinfo-meaning": "text"
    },
    "codigo_siaf": {
      "type": "string",
      "description": "SIAF entity code; retain leading zeros.",
      "x-latinfo-meaning": "code"
    },
    "codigo_consucode": {
      "type": "string",
      "description": "OSCE internal entity code.",
      "x-latinfo-meaning": "identifier"
    },
    "estado": {
      "type": "string",
      "description": "Publisher status; interpret in the context of this dataset.",
      "x-latinfo-meaning": "text"
    },
    "ultima_actualizacion": {
      "type": "string",
      "description": "Published ultima actualizacion date. Format: DD/MM/YY.",
      "x-latinfo-meaning": "date"
    }
  },
  "required": [
    "ruc",
    "nombre",
    "departamento",
    "provincia",
    "distrito",
    "codigo_siaf",
    "codigo_consucode",
    "estado",
    "ultima_actualizacion"
  ],
  "additionalProperties": false
}

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