Español
EspañolEnglishPortuguêsFilipino
Crear clave gratis
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.

Contrato de la fuente

Publicador
OSCE / OECE, Peru
Cobertura
Published construction notebooks associated with legal-entity contractors/consortium members.
Qué representa un registro
A works notebook and contractor membership record.
Identificador
Lookup by ruc_contratista 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

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

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

qstringqueryobligatorio

Name query, 3–200 characters.

Ejemplo de solicitud

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

[].id string
[].razon_social_contratista string

Registered name of the principal contractor.

[].razon_social_entidad string

Name of the contracting public entity.

Esquema de respuesta
{
  "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.
No se documentó un cuerpo de respuesta.
401Missing or invalid API key. Authenticate before retrying.
No se documentó un cuerpo de respuesta.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
No se documentó un cuerpo de respuesta.
409Source generation changed during paginated retrieval. Restart from offset 0.
No se documentó un cuerpo de respuesta.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
No se documentó un cuerpo de respuesta.
503Source unavailable. Report unavailable, not an empty result.
No se documentó un cuerpo de respuesta.
Ejemplo JSON

Ejemplo ilustrativo del esquema. No es una respuesta en vivo.

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

Procedencia y limitaciones

La cobertura varía por país y fuente pública. Un campo ausente no demuestra que el hecho no exista. Los registros públicos pueden tener retrasos o errores; revisa la evidencia y la fecha de la fuente antes de usar un resultado.

Esc