Search osce · penalidades
https://api.latinfo.dev/pe/osce/penalidades/search
Search the published entidad_contratante 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 da fonte
- Publicador
- OSCE / OECE, Peru
- Cobertura
- Published contractual penalties for legal-entity suppliers.
- Significado do registro
- A contract penalty, identified by contract and publication attributes.
- Identificador
- Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
- Padrão aceito
^\d{11}$- Quantidade de registros
many- Licença
- A permissão de reutilização não foi verificada. Acesso público não equivale a uma licença de reutilização.
Limitações conhecidas
- Amounts are PEN strings and can use decimal commas; preserve contract context.
Parâmetros
qstringqueryobrigatórioName query, 3–200 characters.
Exemplo de requisição
curl https://api.latinfo.dev/pe/osce/penalidades/search?q=q \
-H "Authorization: Bearer $LATINFO_API_KEY"
Respostas
200Published source records. Missing data is not a clearance or a negative finding.
Cabeçalhos da resposta
X-Latinfo-Imported-AtImport time, not the date of the government observation.
X-Source-Updated-AtPublisher update time, when known.
X-Latest-Observation-AtLatest date in returned records, when known.
X-Freshness-Statusstring
CURRENT · DELAYED · STALE · UNKNOWNX-Credits-CostActual credits charged for this request.
X-Source-GenerationOpaque immutable source generation. Follow the guarded next-page Link when collecting a history.
X-Total-CountExact row count for this identifier when pagination is requested.
X-Page-Offsetinteger
X-Page-Limitinteger
LinkNext page URL, rel=next. Absent at the end.
application/jsonCampos da resposta
[].id string[].entidad_contratante stringPublic buyer that applied the penalty; not the supplier name.
[].tipo_penalidad stringPublished penalty category, including late delivery and other penalties.
Esquema de resposta
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entidad_contratante": {
"type": "string",
"description": "Public buyer that applied the penalty; not the supplier name.",
"x-latinfo-meaning": "text"
},
"tipo_penalidad": {
"type": "string",
"description": "Published penalty category, including late delivery and other penalties.",
"x-latinfo-meaning": "text"
}
}
}
}400Invalid identifier or query. Correct the input before retrying.
401Missing or invalid API key. Authenticate before retrying.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
409Source generation changed during paginated retrieval. Restart from offset 0.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
503Source unavailable. Report unavailable, not an empty result.
Exemplo JSON
Exemplo ilustrativo do esquema. Não é uma resposta ao vivo.
[
{
"id": "string",
"entidad_contratante": "string",
"tipo_penalidad": "string"
}
]Procedência e limitações
A cobertura varia por país e fonte pública. Um campo ausente não comprova que o fato não exista. Os registros públicos podem ter atrasos ou erros; revise as evidências e a data da fonte antes de usar um resultado.