Español
EspañolEnglishPortuguêsFilipino
Crear clave gratis
Peru · pe_oefa_sanctions_search
OpenAPI

Search oefa · sanctions

GET https://api.latinfo.dev/pe/oefa/sanctions/search

Search the published nombre 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
OEFA, Peru
Cobertura
Published environmental enforcement cases for legal-entity RUCs.
Qué representa un registro
A sanctioned-entity case/resolution; one company can have multiple records.
Identificador
Lookup by ruc 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

  • multa_expediente is in UIT, not PEN; narrative detail is truncated to 500 characters.

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/oefa/sanctions/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
[].nombre string

Published entity name.

[].tipo_sancion string

Published sanction type, such as MULTA or AMONESTACION.

Esquema de respuesta
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      },
      "nombre": {
        "type": "string",
        "description": "Published entity name.",
        "x-latinfo-meaning": "text"
      },
      "tipo_sancion": {
        "type": "string",
        "description": "Published sanction type, such as MULTA or AMONESTACION.",
        "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",
    "nombre": "string",
    "tipo_sancion": "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