Saltar al contenido principal
Docs Sitio Planes

Consulta DNI

Devuelve nombres y apellidos de un DNI registrado como contribuyente en SUNAT: primero en el padrón reducido y, si no está, en SUNAT en línea.

POST https://api.factosperu.com/api/v1/dni

Solicitud

Encabezados: Authorization: Bearer TU_TOKEN y Content-Type: application/json.

{ "dni": "12345678" }

El campo dni es obligatorio, debe tener 8 caracteres y pasar una validación de dígitos.

Respuesta

Toda respuesta trae success, code, retryable y time, más data si hubo éxito o message si hubo error.

{
  "success": true,
  "code": "found",
  "retryable": false,
  "data": {
    "numero": "…",
    "nombre_completo": "…",
    "nombres": "…",
    "apellido_paterno": "…",
    "apellido_materno": "…",
    "codigo_verificacion": 0
  },
  "time": 0.12
}

La API separa el nombre completo usando la primera palabra como apellido paterno, la segunda como apellido materno y las restantes como nombres. codigo_verificacion es el último dígito del RUC 10 de la persona.

Códigos: 200 encontrado; 404 no figura en SUNAT (not_found) o SUNAT no respondió (retryable: true); 422 si no son 8 dígitos (code: invalid_dni).