Ir al contenido

Consulta de RUC

Recupera la ficha SUNAT de un contribuyente a partir de su RUC.

Endpoint

GET /v1/ruc/{ruc}
Host: api.chequea.pe
Authorization: Bearer ak_live_...


Método	`GET`
Scope requerido	`ruc:read`
Cuota	1 unidad por request
Cache HTTP	`public, max-age=3600, must-revalidate`

Parámetros de ruta

Nombre	Tipo	Validación	Descripción
`ruc`	string	11 dígitos	Número de RUC SUNAT

Ejemplo de request

curl --request GET \
  --url https://api.chequea.pe/api/v1/ruc/20100070970 \
  --header 'Authorization: Bearer ak_live_TU_CLAVE'

Respuesta `200 OK`

{
  "ruc": "20100070970",
  "razonSocial": "BANCO DE CREDITO DEL PERU",
  "estado": "ACTIVO",
  "condicion": "HABIDO",
  "tipo": "SOCIEDAD ANONIMA",
  "ubigeo": "150101",
  "direccion": "CAL. CENTENARIO NRO. 156 URB. LAS LADERAS DE MELGAREJO",
  "ciiu": "64190",
  "actualizado": "2026-05-19T03:14:22.881Z"
}

Campos

Campo	Tipo	Notas
`ruc`	string	Mismo valor del parámetro de ruta
`razonSocial`	string	Denominación oficial SUNAT
`estado`	string \| null	`ACTIVO`, `BAJA DE OFICIO`, `SUSPENSION TEMPORAL`, etc.
`condicion`	string \| null	`HABIDO`, `NO HABIDO`, `PENDIENTE`
`tipo`	string \| null	Tipo de contribuyente declarado en SUNAT
`ubigeo`	string \| null	Código INEI de 6 dígitos del domicilio fiscal
`direccion`	string \| null	Domicilio fiscal tal como lo publica SUNAT
`ciiu`	string \| null	Código CIIU declarado (puede estar vacío)
`actualizado`	string (ISO-8601)	Última actualización en nuestro padrón

Errores comunes

Código	`type`	Cuándo ocurre
`400`	`validation_error`	El RUC no cumple el formato (11 dígitos)
`401`	`unauthorized`	Falta `Authorization` o la clave es inválida
`403`	`forbidden_scope`	La clave existe pero no tiene `ruc:read`
`404`	`not_found`	El RUC no figura en el padrón SUNAT
`429`	`rate_limited` / `quota_exceeded`	Excediste tu plan; mira `Retry-After`

Todos los errores siguen Problem Details (RFC 7807). Detalles en Errores.

Caché y `If-None-Match`

La respuesta incluye ETag. Si envías If-None-Match con el ETag previo y los datos no cambiaron, recibes 304 Not Modified (sin body). El 304 consume 1 unidad de cuota (igual que un GET normal); el ahorro está en el ancho de banda, no en el contador.

Probar en el playground Ejecuta este endpoint contra tu clave desde el navegador.