Consultar un DNI
Encuentra el nombre de una persona que tiene RUC 10, es decir, que se registró en SUNAT como persona natural con negocio. Su RUC es 10 + DNI + un dígito verificador. Faktura lo calcula y lo busca en el mismo padrón de SUNAT de la consulta de RUC. No consulta a RENIEC.
Método: GET
Endpoint
Sección titulada «Endpoint»GET https://faktura-test.cgallardo.me/v1/lookup/dni/{dni}GET https://faktura.cgallardo.me/v1/lookup/dni/{dni}Ejemplo
Sección titulada «Ejemplo»curl https://faktura-test.cgallardo.me/v1/lookup/dni/46779354 -H "Authorization: Bearer sk_test_..."use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->get('https://faktura-test.cgallardo.me/v1/lookup/dni/46779354');
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/lookup/dni/46779354', { headers: { Authorization: 'Bearer sk_test_...', },});const data = await response.json();Respuesta 200 OK
Sección titulada «Respuesta 200 OK»{ "dni": "46779354", "full_name": "QUISPE MAMANI JUAN CARLOS", "ruc": "10467793549", "as_of": "2026-11-15" }| Campo | Descripción |
|---|---|
full_name |
Como figura en el padrón de SUNAT: apellidos y nombres. |
ruc |
El RUC 10 del que proviene el nombre. |
as_of |
Fecha del padrón de SUNAT usado. |
Errores
Sección titulada «Errores»| Estado | reason |
Causa |
|---|---|---|
422 |
InvalidDni |
No son 8 dígitos. |
404 |
DniNotFound |
La persona no tiene RUC 10 en el padrón. No significa que el DNI no exista: la mayoría de personas no tiene RUC. Pide el nombre al cliente. |
503 |
DniLookupUnavailable |
El servicio de consulta no está disponible temporalmente. |
Para una boleta no necesitas esta consulta: envía el nombre que te dé el cliente. Úsala para autocompletar cuando se pueda.