Saltar al contenido principal
Consultas

API de consulta DNI para Perú

Obtén nombres, apellidos y domicilio a partir de un DNI de 8 dígitos y valida la identidad de tus clientes desde tu propio sistema, uno por uno o en lote.

Para qué sirve

  • Autocompletar nombres y apellidos en formularios de registro o de venta.
  • Emitir boletas con el nombre correcto del cliente a partir de su DNI.
  • Verificar la identidad de un usuario antes de activar una cuenta o un crédito.
  • Depurar bases de clientes con DNI mal escritos o nombres incompletos.
  • Validar datos de trabajadores o proveedores personas naturales en el alta.

Qué devuelve la API DNI

La consulta individual recibe el número en la URL y responde un JSON con success y un objeto datos. Estos son los campos que encontrarás:

CampoContenido
dniEl número consultado, 8 dígitos.
nombresNombre o nombres de la persona, en mayúsculas.
ape_paterno / ape_maternoApellidos por separado, para que los guardes en columnas distintas.
fecha_nacimiento / edadFecha en formato dd/mm/aaaa y edad calculada, cuando la fuente los trae.
domiciliadoDirección, distrito, provincia, departamento y ubigeo de 6 dígitos.

La consulta masiva recibe un arreglo dnis y devuelve cantidad y un arreglo resultados. Cada elemento es independiente: si un DNI no se pudo obtener, ese ítem trae un campo error y los demás siguen siendo válidos. Revisa siempre ese campo antes de guardar.

Algunos campos pueden venir vacíos según lo que tenga la fuente para esa persona. Programa tu sistema para tolerarlo y no dar por hecho que siempre habrá dirección o fecha de nacimiento.

Uso responsable y protección de datos

Los datos de un DNI son datos personales. Usa esta API solo para validar la identidad de tus clientes, usuarios o trabajadores con una finalidad legítima —por ejemplo, emitir un comprobante o confirmar quién abre una cuenta— y cumpliendo la Ley 29733, Ley de Protección de Datos Personales, y su reglamento.

  • Consulta solo los DNI que la persona te dio para una operación concreta.
  • Guarda únicamente los campos que necesitas y por el tiempo que los necesitas.
  • Informa en tu política de privacidad para qué usas esos datos.
  • No uses la API para armar perfiles, buscar personas o revender información.

Esto es una orientación general, no asesoría legal. Si tu caso es sensible, consúltalo con un especialista.

Cómo empezar

  1. Crea tu cuenta gratis en miapi.cloud; el plan gratuito te permite probar sin tarjeta.
  2. Copia tu token desde el panel admin.miapi.cloud.
  3. Envíalo en cada petición en la cabecera Authorization: Bearer TU_TOKEN, siempre por HTTPS.

Haz una primera prueba con el DNI ficticio 00000000 para ver la forma de la respuesta y luego conecta tu formulario: cuando el usuario escriba 8 dígitos, llama a la API desde tu servidor y rellena los campos de nombre.

La cantidad de consultas disponibles depende de tu plan; revisa los planes en miapi.cloud/#planes. Si tienes dudas para integrarla, escríbenos por WhatsApp.

Buenas prácticas de integración

  • Valida el formato antes de consultar: exactamente 8 dígitos numéricos. Así evitas gastar consultas en números mal escritos.
  • Guarda en caché el resultado de un DNI ya consultado en tu base de datos; los nombres no cambian de un día para otro.
  • Reintenta solo errores temporales (5xx), con espera progresiva. Un 404 o 422 no se arregla reintentando.
  • Usa la consulta masiva para depurar listas o importar clientes desde Excel en lugar de miles de llamadas sueltas.

Guarda el token en el servidor, en una variable de entorno o en tu gestor de secretos. No lo pongas en el código de una página web ni en una app móvil: cualquiera podría leerlo y gastar tus consultas. Si sospechas que se filtró, genera uno nuevo desde el panel.

¿Además necesitas datos de empresas? Combínala con la API de consulta RUC: un mismo formulario puede aceptar DNI para boletas y RUC para facturas.

Referencia de la API

Todas las peticiones llevan tu token en la cabecera Authorization: Bearer TU_TOKEN. Lo copias desde tu panel en admin.miapi.cloud después de crear tu cuenta gratis. Más detalles en la documentación.

Consulta de datos DNI

Consulta los datos de una persona a partir de un DNI de 8 dígitos.

GET https://miapi.cloud/v1/dni/{numero}

Petición
curl -X GET "https://miapi.cloud/v1/dni/00000000" \
  -H "Authorization: Bearer TU_TOKEN"
Respuesta de ejemplo (datos ficticios)
{
  "success": true,
  "datos": {
    "dni": "00000000",
    "nombres": "NOMBRE DE EJEMPLO",
    "ape_paterno": "APELLIDO",
    "ape_materno": "APELLIDO",
    "fecha_nacimiento": "01/01/1990",
    "edad": 35,
    "domiciliado": {
      "direccion": "AV. DE EJEMPLO 123",
      "distrito": "LIMA",
      "provincia": "LIMA",
      "departamento": "LIMA",
      "ubigeo": "150101"
    }
  }
}

Consulta Masiva de DNI

Consulta varios DNI en una sola petición; los inválidos devuelven un error por ítem.

POST https://miapi.cloud/v1/dni/masivo

Petición
curl -X POST "https://miapi.cloud/v1/dni/masivo" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"dnis":["00000000","00000001"]}'
Respuesta de ejemplo (datos ficticios)
{
  "success": true,
  "cantidad": 2,
  "resultados": [
    {
      "dni": "00000000",
      "nombres": "NOMBRE DE EJEMPLO",
      "ape_paterno": "APELLIDO",
      "ape_materno": "APELLIDO",
      "domiciliado": {
        "direccion": "AV. DE EJEMPLO 123",
        "distrito": "LIMA",
        "provincia": "LIMA",
        "departamento": "LIMA"
      }
    },
    {
      "dni": "00000001",
      "error": "No se pudieron obtener los datos del DNI."
    }
  ]
}

Errores frecuentes

CódigoQué significa
401Token ausente, mal escrito o inválido. Revisa la cabecera Authorization: Bearer TU_TOKEN.
404 / 422El DNI no tiene un formato válido o no se encontraron datos para él. Valida el número antes de consultar y no reintentes el mismo número.
429Alcanzaste el límite de consultas de tu plan o enviaste demasiadas peticiones seguidas. Espera o amplía tu plan.
5xxLa fuente oficial o nuestro servicio no respondió en ese momento. Reintenta con espera progresiva.

Preguntas frecuentes

¿La API DNI es de RENIEC?

No. MiAPI Cloud es un servicio independiente que consulta fuentes públicas oficiales; no está afiliado a RENIEC ni a SUNAT.

¿Puedo probar la API DNI gratis?

Sí. Al registrarte en miapi.cloud tienes un plan gratuito para probar. La cantidad de consultas depende de cada plan; revisa los planes en miapi.cloud/#planes.

¿Puedo consultar varios DNI a la vez?

Sí, con el endpoint de consulta masiva envías un arreglo de DNI y recibes un resultado por cada uno. Los que no se pudieron obtener vienen con un campo error, sin afectar al resto.

¿Qué hago si un DNI no devuelve datos?

Verifica que tenga 8 dígitos y que esté bien escrito. Si el formato es correcto y no hay datos, pide al cliente que confirme su número; no reintentes el mismo DNI en bucle.

¿Puedo usar los datos del DNI para cualquier fin?

No. Úsalos solo para validar la identidad de tus clientes o usuarios con una finalidad legítima y cumpliendo la Ley 29733 de Protección de Datos Personales.

APIs relacionadas

Empieza gratis hoy

Crea tu cuenta gratis, copia tu token y haz tu primera consulta en minutos. Sin tarjeta de crédito.