Ir al contenido

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

GET https://faktura-test.cgallardo.me/v1/lookup/dni/{dni}
Ventana de terminal
curl https://faktura-test.cgallardo.me/v1/lookup/dni/46779354 -H "Authorization: Bearer sk_test_..."
{ "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.
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.