API de DNI Perú: nombres y apellidos por DNI o carné de extranjería

Qué problema resuelve

Un formulario que pide el DNI y el nombre por separado acepta cualquier combinación: el usuario escribe un número ajeno, o el suyo con un nombre inventado, y el sistema no tiene cómo notarlo. Validar que el nombre corresponde al documento en el momento del registro corta ese fraude en la puerta, pero exige una consulta que un backend pueda hacer sin intervención humana, y en Perú no hay una consulta pública de identidad pensada para eso. Este endpoint la entrega como una llamada REST con un contrato estable.

Para quién sirve

Fintech, billeteras y plataformas de crédito que validan clientes peruanos en el registro, marketplaces y plataformas de movilidad que dan de alta conductores y vendedores, empresas de cobranza que depuran bases, áreas de recursos humanos que verifican candidatos, y equipos que ya integraron la verificación de identidad colombiana de PlacApi y quieren cubrir Perú con el mismo cliente.

Datos requeridos

• documento — DNI de 8 dígitos o carné de extranjería de 9 a 12, sin puntos ni espacios. Alias aceptados: dni y doc.
• tipoDocumento — opcional: DNI (por defecto) o CE para carné de extranjería.
• refresh — opcional: salta la caché y vuelve a preguntarle al registro.

Fuentes y cobertura

• MTC — registro de personas del Portal Único del ConductorEl Ministerio de Transportes y Comunicaciones mantiene un registro de personas por DNI y carné de extranjería para sus trámites de conductores. Responde nombres y apellidos tanto de personas con licencia como sin ella. No publica fecha de nacimiento, sexo ni estado vital.

¿Qué API devuelve el nombre de una persona por su DNI en Perú?

PlacApi publica /api/identidad-pe: se le envía el DNI (o el CE con tipoDocumento: CE) y responde nombre, nombres y apellidos. La respuesta usa el mismo sobre que el resto del catálogo —source, status, data, mode, fetchedAt— y el mismo bloque cobertura, que dice campo por campo qué publica el registro y qué no.

PlacApi no es RENIEC ni consulta a RENIEC: el dato sale del registro de personas del MTC. Para el caso de uso habitual —confirmar que un nombre corresponde a un documento— eso basta; si tu proceso exige la fecha de nacimiento o el estado vital, esta fuente no los tiene y la respuesta lo declara en vez de inventarlos.

Cómo comparar el nombre que escribió el usuario con el que devuelve la API

Comparar cadenas exactas falla con casos reales: tildes que el usuario pone y el registro no, segundos nombres omitidos, apellidos compuestos, la partícula «VDA DE» en el apellido de casada. Lo que funciona es normalizar las dos cadenas (mayúsculas, sin tildes, sin dobles espacios) y exigir que el primer apellido coincida y que al menos un nombre coincida, en vez de exigir la cadena completa.

Por eso la respuesta trae nombres y apellidos por separado además de nombre: el corte entre nombres y apellidos ya viene hecho por el registro y no hay que adivinarlo con una regla sobre la cantidad de palabras.

DNI y carné de extranjería en el mismo endpoint

Perú tiene una población extranjera residente grande y una verificación que solo acepta DNI deja fuera a buena parte de los usuarios reales de una app de movilidad o de una fintech. /api/identidad-pe acepta los dos: el DNI por defecto y el CE con tipoDocumento: CE. Cada tipo se valida por su largo antes de consultar: 8 dígitos para el DNI, de 9 a 12 para el CE. Un documento que no cumple responde 400 sin cobrar.

¿Cuánto cuesta la API de DNI Perú?

1 crédito por consulta con datos: 349 COP en el tramo de entrada y hasta 99 COP por volumen, sin mensualidad y con créditos que no vencen. Un DNI mal formado responde 400 sin cobrar, un fallo del registro reembolsa el crédito reservado y una consulta repetida que sale del caché tampoco cobra.

¿Es una API de RENIEC?

No. PlacApi no es RENIEC ni consulta a RENIEC: los nombres salen del registro de personas del Ministerio de Transportes y Comunicaciones, que responde por DNI y carné de extranjería. Por eso la respuesta trae nombres y apellidos pero no fecha de nacimiento, sexo ni estado vital, y lo declara en cobertura.noPublicados.

Ejemplo de solicitud

POST https://placapi.com/api/identidad-pe. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.

curl -X POST 'https://placapi.com/api/identidad-pe' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"documento":"00000000","tipoDocumento":"DNI"}'

Parámetros, errores y ejemplos en cURL, JavaScript y Python: documentación de POST /api/identidad-pe.

Ejemplo de respuesta

Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).

{
  "source": "identidad",
  "status": "ok",
  "data": {
    "documento": "00000000",
    "tipoDocumento": "DNI",
    "nombre": "JUAN CARLOS PEREZ GOMEZ",
    "nombres": "JUAN CARLOS",
    "apellidos": "PEREZ GOMEZ",
    "fechaNacimiento": null,
    "edad": null,
    "sexo": null,
    "isAlive": null,
    "cobertura": {
      "nombre": true,
      "fechaNacimiento": false,
      "sexo": false,
      "isAlive": false,
      "noPublicados": [
        "fechaNacimiento",
        "sexo",
        "isAlive"
      ]
    }
  },
  "mode": "live",
  "fetchedAt": "2026-11-07T15:04:05.000Z"
}

Explicación campo por campo

Limitaciones y posibles errores

• Solo nombres y apellidos. Fecha de nacimiento, edad, sexo y estado vital no existen en esta fuente y llegan en null, declarados en cobertura.noPublicados.
• No es una consulta a RENIEC ni reemplaza una verificación biométrica: confirma que un nombre corresponde a un documento, no que quien está al otro lado de la pantalla sea esa persona.
• Si el registro no responde, la API devuelve 502 source_error sin cobrar y no sustituye el dato por un padrón alternativo.
• Quien consulta responde por tener una finalidad legítima para tratar el dato, conforme a la Ley 29733 de protección de datos personales del Perú.

Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.

Otras preguntas frecuentes

Seguir explorando

• API RUC Perú: empresas por RUC (SUNAT) y SUNARP→
• Récord de conductor por DNI (MTC) vía API→
• Verificación de identidad en Colombia por cédula→
• Referencia del endpoint POST /api/identidad-pe→
• Todos los endpoints de Perú→