endpoint.pe

Consulta DNI

Nombres y apellidos del titular de un DNI según RENIEC, con el dígito verificador del documento y el RUC de persona natural si lo tiene.

GEThttps://api.endpoint.pe/v1/dni/{dni}
Fuente:
RENIEC
Costo:
1 crédito por consulta con resultado
Estado:
Disponible
Probar en el playground Página de la API

Devuelve la identidad asociada a un número de DNI según RENIEC: nombres, apellido paterno, apellido materno, el dígito verificador del documento y, si la persona está inscrita en SUNAT como persona natural, su RUC. Está pensada para completar formularios sin errores de tipeo y para verificar que un DNI corresponde a la persona que dice ser.

Solo identidad: no devuelve domicilio, fecha de nacimiento, sexo ni ninguna otra información del titular.

Parámetros

NombreDóndeFormato
dniRuta8 dígitos, con los ceros a la izquierda incluidos. Si no cumple, la API responde 422 sin consultar la fuente.

Ejemplo

El ejemplo usa un DNI y una persona ficticios.

terminal
curl 'https://api.endpoint.pe/v1/dni/45871236' \  -H 'Authorization: Bearer TU_TOKEN'
respuesta.json
{  "success": true,  "message": "Consulta exitosa",  "data": {    "dni": "45871236",    "digito_verificador": "6",    "nombres": "MARÍA ELENA",    "apellido_paterno": "QUISPE",    "apellido_materno": "HUAMÁN",    "nombre_completo": "MARÍA ELENA QUISPE HUAMÁN",    "ruc": "10458712366"  },  "meta": {    "fuente": "RENIEC",    "consultado_en": "2026-10-12T07:40:12Z",    "creditos_cobrados": 1,    "creditos_disponibles": 14621  }}

Campos de data

CampoDescripción
dniNúmero de DNI consultado.
digito_verificadorDígito verificador que figura en el documento.
nombresNombres del titular.
apellido_paternoApellido paterno.
apellido_maternoApellido materno.
nombre_completoNombres y apellidos en una sola cadena.
rucRUC de persona natural (10 + DNI + dígito) si está inscrito en SUNAT; si no, null.

Detalles

  • digito_verificador es el dígito que figura en el DNI, el que piden algunos trámites. Cuando la fuente no lo trae, se calcula con el algoritmo de RENIEC.
  • ruc es el RUC de persona natural: 10, el DNI y un dígito verificador. Solo se devuelve si está inscrito en el padrón de SUNAT; si no, null. Con él puedes pedir la ficha en Consulta RUC.
  • nombre_completo une nombres, apellido paterno y apellido materno, en ese orden.
  • Los nombres llegan en mayúsculas, tal como los registra RENIEC.
  • Un DNI con formato válido pero sin registro en la fuente responde 404, sin costo.
  • Son datos personales: usa la consulta con una finalidad legítima y conserva solo lo necesario, según la Ley N.º 29733. Ver Buenas prácticas.

Guías: Qué es el DNI y qué datos contiene, Cómo validar un DNI en tu sistema y Autocompletar nombres con el DNI en formularios.

Errores

HTTPerrorCuándo
404no_encontradoEl DNI no tiene registro en la fuente. No descuenta créditos.
422validaciondetalles.dni: "DNI inválido: deben ser 8 dígitos."

Los demás códigos (401, 402, 403, 502) son comunes a todas las APIs: Errores.

Relacionados