Peru · pe_osce_cod_cuadernos_search
OpenAPI

Search osce · cod-cuadernos

GET https://api.latinfo.dev/pe/osce/cod-cuadernos/search

Search the published razon_social_contratista index. Results are candidates, not confirmed identity matches. Confirm the country and identifier before fetching a profile. An empty list is not proof of absence.

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

qstringquerykailangan

Name query, 3–200 characters.

Halimbawa ng request

curl https://api.latinfo.dev/pe/osce/cod-cuadernos/search?q=q \
  -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

[].id string
[].razon_social_contratista string

Registered name of the principal contractor.

[].razon_social_entidad string

Name of the contracting public entity.

Response schema
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      },
      "razon_social_contratista": {
        "type": "string",
        "description": "Registered name of the principal contractor.",
        "x-latinfo-meaning": "text"
      },
      "razon_social_entidad": {
        "type": "string",
        "description": "Name of the contracting public entity.",
        "x-latinfo-meaning": "text"
      }
    }
  }
}
400Invalid identifier or query. Correct the input before retrying.
Walang nakadokumentong response body.
401Missing or invalid API key. Authenticate before retrying.
Walang nakadokumentong response body.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
Walang nakadokumentong response body.
409Source generation changed during paginated retrieval. Restart from offset 0.
Walang nakadokumentong response body.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
Walang nakadokumentong response body.
503Source unavailable. Report unavailable, not an empty result.
Walang nakadokumentong response body.
Halimbawang JSON

Halimbawa ng schema lamang. Hindi ito live na tugon.

[
  {
    "id": "string",
    "razon_social_contratista": "string",
    "razon_social_entidad": "string"
  }
]

Pinagmulan at mga limitasyon

Nag-iiba ang saklaw ayon sa bansa at pampublikong source. Ang nawawalang field ay hindi patunay na wala ang katotohanan. Maaaring maantala o magkamali ang mga rehistro; suriin ang ebidensya at petsa bago gamitin ang resulta.