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
Endpoint
Sección titulada «Endpoint»GET https://faktura-test.cgallardo.me/v1/lookup/ruc/{ruc}GET https://faktura.cgallardo.me/v1/lookup/ruc/{ruc}Ejemplo
Sección titulada «Ejemplo»curl https://faktura-test.cgallardo.me/v1/lookup/ruc/20131312955 -H "Authorization: Bearer sk_test_..."use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->get('https://faktura-test.cgallardo.me/v1/lookup/ruc/20131312955');
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/lookup/ruc/20131312955', { headers: { Authorization: 'Bearer sk_test_...', },});const data = await response.json();Respuesta 200 OK
Sección titulada «Respuesta 200 OK»{ "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. |
Errores
Sección titulada «Errores»| 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.