Ir al contenido

Consultar un RUC

Sirve para autocompletar los datos del cliente en tu POS antes de emitir.

Consulta el padrón reducido de RUC publicado por SUNAT y actualizado diariamente en Faktura. No depende de los servicios en línea de SUNAT en el momento de la petición, por lo que responde en milisegundos incluso si SUNAT presenta intermitencias. as_of indica la fecha de publicación del padrón usado.

Método: GET

GET https://faktura-test.cgallardo.me/v1/lookup/ruc/{ruc}
Ventana de terminal
curl https://faktura-test.cgallardo.me/v1/lookup/ruc/20131312955 -H "Authorization: Bearer sk_test_..."
{
"ruc": "20131312955",
"name": "EMPRESA DE PRUEBA S.A.C.",
"status": "ACTIVO",
"address_condition": "HABIDO",
"is_active_and_found": true,
"ubigeo": "150122",
"address": "AV. LARCO NRO. 123 INT. 402 URB. MIRAFLORES",
"as_of": "2026-11-13"
}
Campo Descripción
status Estado del contribuyente (ACTIVO, BAJA DE OFICIO, SUSPENSION TEMPORAL…).
address_condition Condición del domicilio (HABIDO, NO HALLADO, NO HABIDO…).
is_active_and_found true si está ACTIVO y HABIDO. Es informativo: la API no bloquea facturas a contribuyentes en otro estado.
address, ubigeo Domicilio fiscal armado como lo muestra SUNAT; null si el padrón no lo trae.
as_of Fecha (hora de Perú) en que SUNAT publicó el padrón consultado.
Estado reason Causa
422 InvalidRuc No tiene 11 dígitos o el dígito verificador es incorrecto (se valida antes de consultar).
404 RucNotFound No figura en el padrón.
503 RucLookupUnavailable El servicio de consulta no está disponible temporalmente. Reintenta más tarde.

Para muchos RUC a la vez, usa Consultar varios RUC.