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

Publicador: OSCE / OECE, Peru
Cobertura: Public contracting entities in the published OSCE directory.
Significado do 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.
Padrão aceito: ^\d{11}$
Quantidade de registros: one
Licença: A permissão de reutilização não foi verificada. Acesso público não equivale a uma licença de reutilização.

Limitações conhecidas

Directory inclusion is not evidence of a specific procurement award.

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

rucstringpathobrigatório

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

Example: 20290898685

Exemplo de requisição

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

ruc string obrigatório

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

nombre string obrigatório

Published entity name.

departamento string obrigatório

Published department name.

provincia string obrigatório

Published province name.

distrito string obrigatório

Published district name.

codigo_siaf string obrigatório

SIAF entity code; retain leading zeros.

codigo_consucode string obrigatório

OSCE internal entity code.

estado string obrigatório

Publisher status; interpret in the context of this dataset.

ultima_actualizacion string obrigatório

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

Esquema de resposta

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