Skip to content

Reference / MINEM

Printable REINFO report

The REINFO lookup as HTML ready to print.

POST /api/reinfo/html

What it's for: Document a third party's mining formalisation status in a case file.

Authentication

X-API-Key string header required: X-API-Key: tu_token
Authorization string header: Authorization: Bearer tu_token

Either one works. The token is generated from the client dashboard. Go to the dashboard →

Body parameters

ruc string required: 11-digit tax ID (RUC). Example: 20123456789

Response

Main fields this lookup returns:

documento HTML

Status codes

200 OK: Lookup resolved. Counts one request against the plan.
401 Invalid or expired token: The authentication header is missing or the token isn't valid.
403 No access: The plan doesn't cover this service, or the subscription isn't active.
404 Not found: The lookup ran but returned nothing. It still counts.
429 Limit reached: The period's lookups have run out.
500 Service error: The official source failed to answer. Nothing is cached.

cURL

curl --request POST \
  --url https://perusoftware.dev/api/reinfo/html \
  --header 'X-API-Key: <tu-token>' \
  --form 'ruc=20123456789'

200 · HTML

<!DOCTYPE html>
<html lang="es">
  <head><title>REINFO 20123456789</title></head>
  <body>
    <h1>EMPRESA DE EJEMPLO S.A.C.</h1>
    <p>Registros de formalización minera vigentes.</p>
  </body>
</html>

Only the successful response is HTML. On failure —expired token, quota used up, unknown tax ID— you get JSON with a detail field.

Example values; field names are the real ones.

Try it

POST /api/reinfo/html

Your token Used for this request only. Never stored. ruc in the body 11-digit tax ID (RUC)