Lookup osce · valorizaciones by CONTRATO_ID

GET https://api.latinfo.dev/pe/osce/valorizaciones/contrato_id/{contrato_id}

One valuation period for a contract; the identifier is not a company RUC. Coverage: Published construction valuations grouped by OSCE contract identifier. Lookup by contrato_id as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below. Amounts use decimal commas and the currency in tipo_moneda. Accumulated amounts must not be summed across periods. 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 valuations grouped by OSCE contract identifier.
Kahulugan ng tala: One valuation period for a contract; the identifier is not a company RUC.
Identifier: Lookup by contrato_id as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Tinatanggap na pattern: ^\d{10}$
Normalization: padStart:10:0
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

Amounts use decimal commas and the currency in tipo_moneda. Accumulated amounts must not be summed across periods.

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

contrato_idstringpathkailangan

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

Example: 2261629

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/valorizaciones/contrato_id/2261629 \
  -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

[].contrato_id string kailangan

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

[].expediente_id string kailangan

Parent procurement file identifier.

[].valorizacion_id string kailangan

Valuation identifier.

[].codigo_valorizacion string kailangan

Formatted valuation code.

[].tipo_moneda string kailangan

Published currency label, including Soles and USD.

[].sistema_contratacion string kailangan

Published contracting system, including lump sum and unit prices.

[].estado string kailangan

Publisher status; interpret in the context of this dataset.

[].periodo string kailangan

Published duration or coverage-period label; interpret in this dataset.

[].avance_fisico_pct string kailangan

Accumulated executed physical progress; decimal commas are retained. Unit: percent.

percent

[].monto_valorizacion string kailangan

Valuation amount for this period; decimal commas are retained. Unit: currency from tipo_moneda.

currency from tipo_moneda

[].monto_a_pagar string kailangan

Net payable amount after deductions; decimal commas are retained. Unit: currency from tipo_moneda.

currency from tipo_moneda

[].monto_acumulado string kailangan

Cumulative valuation amount through this period; do not sum across periods. Unit: currency from tipo_moneda.

currency from tipo_moneda

[].fecha_registro string kailangan

Published fecha registro date. Format: YYYYMMDD.

Response schema

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "contrato_id": {
        "type": "string",
        "description": "Lookup by contrato_id as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below."
      },
      "expediente_id": {
        "type": "string",
        "description": "Parent procurement file identifier.",
        "x-latinfo-meaning": "identifier"
      },
      "valorizacion_id": {
        "type": "string",
        "description": "Valuation identifier.",
        "x-latinfo-meaning": "identifier"
      },
      "codigo_valorizacion": {
        "type": "string",
        "description": "Formatted valuation code.",
        "x-latinfo-meaning": "identifier"
      },
      "tipo_moneda": {
        "type": "string",
        "description": "Published currency label, including Soles and USD.",
        "x-latinfo-meaning": "text"
      },
      "sistema_contratacion": {
        "type": "string",
        "description": "Published contracting system, including lump sum and unit prices.",
        "x-latinfo-meaning": "text"
      },
      "estado": {
        "type": "string",
        "description": "Publisher status; interpret in the context of this dataset.",
        "x-latinfo-meaning": "text"
      },
      "periodo": {
        "type": "string",
        "description": "Published duration or coverage-period label; interpret in this dataset.",
        "x-latinfo-meaning": "text"
      },
      "avance_fisico_pct": {
        "type": "string",
        "description": "Accumulated executed physical progress; decimal commas are retained. Unit: percent.",
        "x-latinfo-meaning": "percentage",
        "x-latinfo-unit": "percent"
      },
      "monto_valorizacion": {
        "type": "string",
        "description": "Valuation amount for this period; decimal commas are retained. Unit: currency from tipo_moneda.",
        "x-latinfo-meaning": "amount",
        "x-latinfo-unit": "currency from tipo_moneda"
      },
      "monto_a_pagar": {
        "type": "string",
        "description": "Net payable amount after deductions; decimal commas are retained. Unit: currency from tipo_moneda.",
        "x-latinfo-meaning": "amount",
        "x-latinfo-unit": "currency from tipo_moneda"
      },
      "monto_acumulado": {
        "type": "string",
        "description": "Cumulative valuation amount through this period; do not sum across periods. Unit: currency from tipo_moneda.",
        "x-latinfo-meaning": "amount",
        "x-latinfo-unit": "currency from tipo_moneda"
      },
      "fecha_registro": {
        "type": "string",
        "description": "Published fecha registro date. Format: YYYYMMDD.",
        "x-latinfo-meaning": "date"
      }
    },
    "required": [
      "contrato_id",
      "expediente_id",
      "valorizacion_id",
      "codigo_valorizacion",
      "tipo_moneda",
      "sistema_contratacion",
      "estado",
      "periodo",
      "avance_fisico_pct",
      "monto_valorizacion",
      "monto_a_pagar",
      "monto_acumulado",
      "fecha_registro"
    ],
    "additionalProperties": false
  }
}

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