Consulta el padrón RUC de SUNAT en milisegundos

Una API REST sobre el padrón completo de SUNAT, con la razón social, el estado, la condición y la dirección normalizada de cada contribuyente.

Esta API expone únicamente la información pública contenida en el padrón reducido que la SUNAT publica en su sitio web oficial de la SUNAT.

Estado del servicio

Versiónv1.3.0
ServicioComprobando estado
Base de datosSin verificar
Última comprobación—

Dos endpoints, todo el padrón

GET /v1/ruc/:ruc

Devuelve el contribuyente con su dirección compuesta a partir del padrón vigente.

{
  "ruc": "20614244730",
  "nombre": "EBEN EZER | INGENIERIA Y ARQUITECTURA S.A.C.",
  "estado": "ACTIVO",
  "condicion": "HABIDO",
  "ubigeo": "150114",
  "direccion": "CAL. LA PAZ 200 - URB. SANTA PATRICIA ET. UNO"
}

Autenticación

Cada consulta viaja con un JWT en la cabecera Authorization: Bearer <token>. Sin token válido la API responde 401 y no expone ningún dato del padrón.

Dirección compuesta

Cuatro bloques del padrón se unen en una sola línea legible.

VíaTipo y nombre de vía, más el número
DetalleInterior, manzana, lote y kilómetro
ZonaTipo y nombre de la zona o urbanización
DepartamentoDepartamento, provincia y distrito

GET /v1/health

Estado del servicio y de la base de datos. Sin autenticación.

{ "status": "ok", "database": "up" }

{ "status": "degraded", "database": "down" }

Todo el padrón, listo para usar

Respuesta en milisegundos

Una consulta por RUC devuelve todo en una sola llamada.

Padrón completo

Más de 18 millones de contribuyentes, actualizado con cada publicación de SUNAT.

Dirección lista para usar

Vía, número, zona y departamento ya unidos en una sola línea, sin armar nada.

Siempre disponible

Estado monitoreado y respuestas claras incluso cuando la fuente falla.

Solo información pública

Expone únicamente los datos del padrón reducido que la SUNAT publica en su sitio web oficial de la SUNAT; nada más.

RUC·RAZON SOCIAL·ESTADO·CONDICION·UBIGEO·DIRECCION· RUC·RAZON SOCIAL·ESTADO·CONDICION·UBIGEO·DIRECCION·

Obtén tu token y consulta

curl -H "Authorization: Bearer <TU_TOKEN>" \
  https://apis.iteraciona.com/v1/ruc/20614244730
Comprobando estado