Endpoint DNI

Consulta nombres asociados a un DNI cuando la persona tiene un RUC vinculado en SUNAT o se encuentra indexada en eldni.com.

URL

GET /api/dni?numero=XXXXXXXX

Parámetros

Parámetro Tipo Descripción
numero string (requerido) 8 dígitos numéricos.
proveedor string (opcional) sunat-scraper, eldni, apiperu.dev, apis.net.pe.

Nota importante

Este endpoint usa una cadena de proveedores: primero intenta SUNAT (solo si el DNI tiene RUC asociado) y luego cae en eldni como fallback. No accede a RENIEC directamente, por lo que solo retornará datos si la persona figura en alguna de esas fuentes públicas.

Ejemplo de request

curl -X GET "https://apisperu.gsalinas.site/api/dni?numero=12345678" \
  -H "Authorization: Bearer apk_demo_apisperu_pub_2BfHK7nN4tV9X8jE3LpQ5sUcZ"

Ejemplo de response

{
  "ok": true,
  "data": {
    "numero": "12345678",
    "nombres": "JUAN CARLOS",
    "apellidoPaterno": "QUISPE",
    "apellidoMaterno": "MAMANI",
    "nombreCompleto": "QUISPE MAMANI JUAN CARLOS"
  },
  "proveedor": "sunat-scraper"
}

Campos del response

Campo Tipo Descripción
numero string DNI consultado (8 dígitos).
nombres string Nombres de la persona.
apellidoPaterno string Apellido paterno.
apellidoMaterno string Apellido materno.
nombreCompleto string Nombre completo concatenado.

Errores específicos

Probar en el playground