Lookup osce · cod-cuadernos by RUC_CONTRATISTA

GET https://api.latinfo.dev/pe/osce/cod-cuadernos/ruc_contratista/{ruc_contratista}

A works notebook and contractor membership record. Coverage: Published construction notebooks associated with legal-entity contractors/consortium members. Lookup by ruc_contratista as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below. Repeated rows can describe consortium membership; they are not independent contracts. 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.

Kontrata ng source

Publisher: OSCE / OECE, Peru
Saklaw: Published construction notebooks associated with legal-entity contractors/consortium members.
Kahulugan ng tala: A works notebook and contractor membership record.
Identifier: Lookup by ruc_contratista 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: many
Lisensya: Hindi pa nabeberipika ang pahintulot sa muling paggamit. Hindi lisensya sa muling paggamit ang pampublikong access.

Mga kilalang limitasyon

Repeated rows can describe consortium membership; they are not independent contracts.

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

ruc_contratistastringpathkailangan

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

Example: 20605501045

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.

Halimbawa ng request

curl https://api.latinfo.dev/pe/osce/cod-cuadernos/ruc_contratista/20605501045 \
  -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.

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

Mga field ng tugon

[].ruc_contratista string kailangan

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

[].contrato_id string kailangan

OSCE contract identifier.

[].razon_social_contratista string kailangan

Registered name of the principal contractor.

[].ruc_entidad string kailangan

RUC of the contracting public entity.

[].razon_social_entidad string kailangan

Name of the contracting public entity.

[].denominacion_obra string kailangan

Published works description.

[].cuaderno_id string kailangan

Works-notebook UUID.

[].ubigeo string kailangan

Six-digit INEI district code; retain leading zeros.

[].descripcion_ubigeo string kailangan

Published district description.

[].es_consorcio string kailangan

Si/No: whether a consortium executes the contract.

[].ruc_miembro string kailangan

Legal-entity RUC of a consortium member; natural-person RUCs are excluded.

[].nombre_miembro string kailangan

Registered consortium-member name.

Response schema

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "ruc_contratista": {
        "type": "string",
        "description": "Lookup by ruc_contratista as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below."
      },
      "contrato_id": {
        "type": "string",
        "description": "OSCE contract identifier.",
        "x-latinfo-meaning": "identifier"
      },
      "razon_social_contratista": {
        "type": "string",
        "description": "Registered name of the principal contractor.",
        "x-latinfo-meaning": "text"
      },
      "ruc_entidad": {
        "type": "string",
        "description": "RUC of the contracting public entity.",
        "x-latinfo-meaning": "identifier"
      },
      "razon_social_entidad": {
        "type": "string",
        "description": "Name of the contracting public entity.",
        "x-latinfo-meaning": "text"
      },
      "denominacion_obra": {
        "type": "string",
        "description": "Published works description.",
        "x-latinfo-meaning": "text"
      },
      "cuaderno_id": {
        "type": "string",
        "description": "Works-notebook UUID.",
        "x-latinfo-meaning": "identifier"
      },
      "ubigeo": {
        "type": "string",
        "description": "Six-digit INEI district code; retain leading zeros.",
        "x-latinfo-meaning": "code"
      },
      "descripcion_ubigeo": {
        "type": "string",
        "description": "Published district description.",
        "x-latinfo-meaning": "text"
      },
      "es_consorcio": {
        "type": "string",
        "description": "Si/No: whether a consortium executes the contract.",
        "x-latinfo-meaning": "text"
      },
      "ruc_miembro": {
        "type": "string",
        "description": "Legal-entity RUC of a consortium member; natural-person RUCs are excluded.",
        "x-latinfo-meaning": "identifier"
      },
      "nombre_miembro": {
        "type": "string",
        "description": "Registered consortium-member name.",
        "x-latinfo-meaning": "text"
      }
    },
    "required": [
      "ruc_contratista",
      "contrato_id",
      "razon_social_contratista",
      "ruc_entidad",
      "razon_social_entidad",
      "denominacion_obra",
      "cuaderno_id",
      "ubigeo",
      "descripcion_ubigeo",
      "es_consorcio",
      "ruc_miembro",
      "nombre_miembro"
    ],
    "additionalProperties": false
  }
}

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