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.

Kontrata ng source

Publisher: OSCE / OECE, Peru
Saklaw: Public contracting entities in the published OSCE directory.
Kahulugan ng tala: A public buyer registration with administrative geography and internal codes.
Identifier: Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Tinatanggap na pattern: ^\d{11}$
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

Directory inclusion is not evidence of a specific procurement award.

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

rucstringpathkailangan

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

Example: 20290898685

Halimbawa ng request

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

ruc string kailangan

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

nombre string kailangan

Published entity name.

departamento string kailangan

Published department name.

provincia string kailangan

Published province name.

distrito string kailangan

Published district name.

codigo_siaf string kailangan

SIAF entity code; retain leading zeros.

codigo_consucode string kailangan

OSCE internal entity code.

estado string kailangan

Publisher status; interpret in the context of this dataset.

ultima_actualizacion string kailangan

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

Response schema

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