Lookup osce · rnp-by-ruc by RUC

GET https://api.latinfo.dev/pe/osce/rnp-by-ruc/ruc/{ruc}

An anonymous role and position associated with the company, with its effective-start date. Coverage: Governance/ownership-role categories for legal-entity providers in RNP publications. Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below. Person names and document identifiers are excluded. These records cannot identify owners or beneficial owners. Returns all records as an array. Import time is not observation time; inspect freshness headers. Add limit (1–500) and offset to retrieve an explicit page; without them the complete original array is returned. X-Total-Count gives the exact row count; follow Link rel=next to retrieve all pages.

Contrato de la fuente

Publicador: OSCE / OECE, Peru
Cobertura: Governance/ownership-role categories for legal-entity providers in RNP publications.
Qué representa un registro: An anonymous role and position associated with the company, with its effective-start date.
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: many
Licencia: No se ha verificado el permiso de reutilización. El acceso público no equivale a una licencia de reutilización.

Limitaciones conocidas

Person names and document identifiers are excluded. These records cannot identify owners or beneficial owners.

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: 20100000335

limitintegerquery

Optional page size. Supplying limit or offset enables explicit pagination; default page size is 100.

offsetintegerquery

Row offset, default 0. Keep the same source generation while collecting pages.

generationstringquery

Opaque source-generation guard, automatically included in the next-page Link. A changed generation returns 409; restart retrieval.

Ejemplo de solicitud

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

X-Total-Count

Exact row count for this identifier when pagination is requested.

X-Page-Offset

integer

X-Page-Limit

integer

Link

Next page URL, rel=next. Absent at the end.

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.

[].tipo_rol string obligatorio

Published anonymous role category; no person name or document identifier is returned.

[].fecha_inicio_vigencia string obligatorio

Published fecha inicio vigencia date. Format: YYYYMMDD.

[].forma_societaria string obligatorio

Registered company legal form.

[].cargo string obligatorio

Published governance position; empty when no matching position is supplied. No person identity is exposed.

Esquema de respuesta

{
  "type": "array",
  "items": {
    "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."
      },
      "tipo_rol": {
        "type": "string",
        "description": "Published anonymous role category; no person name or document identifier is returned.",
        "x-latinfo-meaning": "text"
      },
      "fecha_inicio_vigencia": {
        "type": "string",
        "description": "Published fecha inicio vigencia date. Format: YYYYMMDD.",
        "x-latinfo-meaning": "date"
      },
      "forma_societaria": {
        "type": "string",
        "description": "Registered company legal form.",
        "x-latinfo-meaning": "text"
      },
      "cargo": {
        "type": "string",
        "description": "Published governance position; empty when no matching position is supplied. No person identity is exposed.",
        "x-latinfo-meaning": "text"
      }
    },
    "required": [
      "ruc",
      "tipo_rol",
      "fecha_inicio_vigencia",
      "forma_societaria",
      "cargo"
    ],
    "additionalProperties": false
  }
}

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