Saltar al contenido

Referencia / MINEM

REINFO

Registro Integral de Formalización Minera del MINEM. Devuelve los derechos mineros asociados a un RUC con su estado.

GET /api/reinfo/{ruc}

Para qué sirve: Comprobar si un proveedor minero está inscrito y en qué estado se encuentra su formalización.

Autenticación

X-API-Key string cabecera requerido
X-API-Key: tu_token
Authorization string cabecera
Authorization: Bearer tu_token

Cualquiera de las dos sirve. El token se genera desde el panel de cliente.

Parámetros de ruta

ruc string requerido
RUC del titular. Ejemplo: 20123456789

Respuesta

Campos principales que devuelve esta consulta:

  • registros[].nombre
  • registros[].codigo_unico
  • registros[].derecho
  • registros[].departamento, provincia, distrito
  • registros[].estado

Las repeticiones de la misma consulta se sirven desde caché durante 30 días y no descuentan de tu plan.

Códigos de estado

200 OK
Consulta resuelta. Descuenta una petición del plan.
401 Token inválido o vencido
Falta la cabecera de autenticación o el token no es válido.
403 Sin acceso
El plan no cubre este servicio o la suscripción no está activa.
404 No encontrado
La consulta se ejecutó pero no hubo resultados. También descuenta.
429 Límite alcanzado
Se agotaron las consultas del período.
500 Error del servicio
Fallo al consultar la fuente oficial. No se guarda en caché.