Consulta DNI

Obtén los datos de una persona a partir de su número de DNI (8 dígitos).

Consideraciones

Devuelve los datos registrales de una persona a partir de su número de DNI.
Este servicio no se conecta con RENIEC.
El origen de datos depende del padrón reducido SUNAT y otras fuentes públicas.
El padrón reducido SUNAT no devuelve datos de menores de edad, dirección, fecha nacimiento, sexo.
En algunos casos no se obtendrá resultado de la consulta debido a la información de las fuentes públicas, esto no debe considerarse como falla o error del servicio.
Disponible en el plan gratuito. Consume 1 consulta de tu plan.

POST https://api.apiperu.dev/dni Copiar

Headers

Name	Type	Description
Accept	String	application/json
Content-Type	string	application/json
Authorization	string	Bearer <token>. Genéralo desde tu panel, en `Api Tokens`.

Body

Name	Type	Description
dni*	string	Número de DNI de 8 dígitos. Ejemplo: `44556677`.

Ejemplo de solicitud

Copiar

curl -X POST https://api.apiperu.dev/dni \
  -H "Accept: application/json" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"dni":"44556677"}'

Copiar

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.apiperu.dev/dni',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode([
        'dni' => '44556677',
    ]),
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer TU_TOKEN',
        'Content-Type: application/json',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

Copiar

const response = await fetch('https://api.apiperu.dev/dni', {
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer TU_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    dni: '44556677',
  }),
});

const data = await response.json();
console.log(data);

Copiar

import requests

response = requests.post(
    'https://api.apiperu.dev/dni',
    headers={
        'Accept': 'application/json',
        'Authorization': 'Bearer TU_TOKEN',
        'Content-Type': 'application/json',
    },
    json={
        'dni': '44556677',
    },
)

print(response.json())

Respuesta

200 OK application/json

{
  "success": true,
  "data": {
    "numero": "44556677",
    "nombre_completo": "PEREZ GARCIA JUAN CARLOS",
    "nombres": "JUAN CARLOS",
    "apellido_paterno": "PEREZ",
    "apellido_materno": "GARCIA",
    "codigo_verificacion": 3
  },
  "time": 0.42
}

404 Not Found application/json

{
  "success": false,
  "message": "DNI no encontrado."
}