Lookup oefa · sanctions by RUC

GET https://api.latinfo.dev/pe/oefa/sanctions/ruc/{ruc}

A sanctioned-entity case/resolution; one company can have multiple records. Coverage: Published environmental enforcement cases for legal-entity RUCs. Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below. multa_expediente is in UIT, not PEN; narrative detail is truncated to 500 characters. 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: OEFA, Peru
Saklaw: Published environmental enforcement cases for legal-entity RUCs.
Kahulugan ng tala: A sanctioned-entity case/resolution; one company can have multiple records.
Identifier: Lookup by ruc 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

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

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

rucstringpathkailangan

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

Example: 20165230974

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/oefa/sanctions/ruc/20165230974 \
  -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

[].ruc string kailangan

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

[].nombre string kailangan

Published entity name.

[].subsector string kailangan

Published economic subsector; a dash may represent unavailable data.

[].departamento string kailangan

Published department name.

[].nro_expediente string kailangan

Environmental enforcement case identifier.

[].nro_rd string kailangan

Directorate resolution identifier.

[].fecha_rd string kailangan

Published fecha rd date. Format: YYYYMMDD.

[].tipo_sancion string kailangan

Published sanction type, such as MULTA or AMONESTACION.

[].tipo_infraccion string kailangan

Published formal infraction severity; not a Latinfo score.

[].medida_dictada string kailangan

Published ordered measure.

[].detalle_infraccion string kailangan

Published infraction narrative; truncated to 500 characters by the importer.

[].multa_expediente string kailangan

Total fine for the environmental case, in UIT. Unit: UIT.

UIT

Response schema

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "ruc": {
        "type": "string",
        "description": "Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below."
      },
      "nombre": {
        "type": "string",
        "description": "Published entity name.",
        "x-latinfo-meaning": "text"
      },
      "subsector": {
        "type": "string",
        "description": "Published economic subsector; a dash may represent unavailable data.",
        "x-latinfo-meaning": "text"
      },
      "departamento": {
        "type": "string",
        "description": "Published department name.",
        "x-latinfo-meaning": "text"
      },
      "nro_expediente": {
        "type": "string",
        "description": "Environmental enforcement case identifier.",
        "x-latinfo-meaning": "identifier"
      },
      "nro_rd": {
        "type": "string",
        "description": "Directorate resolution identifier.",
        "x-latinfo-meaning": "identifier"
      },
      "fecha_rd": {
        "type": "string",
        "description": "Published fecha rd date. Format: YYYYMMDD.",
        "x-latinfo-meaning": "date"
      },
      "tipo_sancion": {
        "type": "string",
        "description": "Published sanction type, such as MULTA or AMONESTACION.",
        "x-latinfo-meaning": "text"
      },
      "tipo_infraccion": {
        "type": "string",
        "description": "Published formal infraction severity; not a Latinfo score.",
        "x-latinfo-meaning": "text"
      },
      "medida_dictada": {
        "type": "string",
        "description": "Published ordered measure.",
        "x-latinfo-meaning": "text"
      },
      "detalle_infraccion": {
        "type": "string",
        "description": "Published infraction narrative; truncated to 500 characters by the importer.",
        "x-latinfo-meaning": "text"
      },
      "multa_expediente": {
        "type": "string",
        "description": "Total fine for the environmental case, in UIT. Unit: UIT.",
        "x-latinfo-meaning": "amount",
        "x-latinfo-unit": "UIT"
      }
    },
    "required": [
      "ruc",
      "nombre",
      "subsector",
      "departamento",
      "nro_expediente",
      "nro_rd",
      "fecha_rd",
      "tipo_sancion",
      "tipo_infraccion",
      "medida_dictada",
      "detalle_infraccion",
      "multa_expediente"
    ],
    "additionalProperties": false
  }
}

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