API de RucPerú

Una API REST sin pretensiones: un endpoint, JSON limpio y límites claros. Funciona sin registro; con una cuenta gratuita el límite sube de 30 a 300 consultas por minuto.

Consultar un RUC

GET /api/ruc/{ruc}

El RUC debe tener 11 dígitos y un dígito verificador válido. Ejemplo:

curl https://www.rucperu.luminacreativa.agency/api/ruc/20131312955

Respuesta cuando el contribuyente existe:

{
  "encontrado": true,
  "contribuyente": {
    "ruc": "20131312955",
    "razon_social": "SUPERINTENDENCIA NACIONAL DE ADUANAS Y DE ADMINISTRACION TRIBUTARIA",
    "estado": "ACTIVO",
    "condicion": "HABIDO"
  },
  "locales": [
    {
      "tipo": "principal",
      "cod_local": "0000",
      "ubigeo": "150101",
      "direccion": "AV. GARCILASO DE LA VEGA NRO. 1472",
      "direccion_hash": "principal"
    }
  ],
  "fuente": {
    "disponible": true,
    "fecha_publicacion": "2026-06-04",
    "desactualizada": false
  }
}

Si el RUC tiene formato válido pero no figura en el padrón, la respuesta es 200 con "encontrado": false — no es un error: significa que la SUNAT no lo publica.

Campos de la respuesta

Campo	Descripción
encontrado	Si el RUC figura en el Padrón Reducido vigente.
contribuyente.estado	Estado ante SUNAT: `ACTIVO`, `BAJA DEFINITIVA`, etc.
contribuyente.condicion	Condición del domicilio: `HABIDO`, `NO HABIDO`, etc.
locales[].tipo	`principal` (domicilio fiscal) o `anexo`.
locales[].cod_local	`0000` para el principal. El padrón no publica el código de los anexos.
locales[].ubigeo	Código UBIGEO de 6 dígitos del distrito.
fuente.desactualizada	`true` si nuestra copia tiene más de 10 días.

Códigos de respuesta

Código	Significado
200	Consulta correcta (incluso si `encontrado` es `false`).
422	El RUC no tiene un formato válido (11 dígitos + dígito verificador).
401	Enviaste una clave de API que no existe o fue regenerada.
429	Superaste tu límite por minuto. Espera y reintenta; revisa las cabeceras `X-RateLimit-*`.

Límites y clave de API

Modo	Límite	Requiere
Anónimo	30 consultas/min por IP	Nada
Con clave	300 consultas/min	Cuenta gratuita

Envía tu clave en la cabecera X-Api-Key (recomendado), como Bearer o como parámetro ?api_key=:

curl -H "X-Api-Key: rp_TU_CLAVE" https://www.rucperu.luminacreativa.agency/api/ruc/20131312955

Estado del servicio

GET /api/estado

Devuelve la frescura de cada fuente importada (fecha de publicación de la SUNAT y fecha de nuestra importación). Úsalo para monitoreo.

Fuente de los datos y uso justo

Los datos provienen exclusivamente del Padrón Reducido, el archivo público que la SUNAT publica a diario. No consultamos sistemas privados ni usamos credenciales. La información se entrega tal como aparece en la fuente; para trámites oficiales verifica siempre en e-Consulta RUC de la SUNAT.

El servicio es gratuito. A cambio te pedimos un uso razonable: cachea tus resultados, no hagas scraping masivo y identifícate con tu clave si integras la API en producción.