Endpoint: identidad Perú (DNI/CE)

Devuelve nombres y apellidos de una persona peruana a partir del DNI (8 dígitos) o del carné de extranjería (9 a 12), contra el Portal Único del Conductor del MTC. La consulta se hace desde una salida peruana y respeta el límite de una llamada por segundo del registro. El documento se valida sin red antes de cobrar: un DNI que no tenga 8 dígitos —o un CE fuera de 9 a 12— responde 400 y no gasta la consulta. Si el registro no responde, la respuesta es source_error sin cobro; no se sustituye por un padrón alternativo. El registro solo publica nombres y apellidos: fecha de nacimiento, sexo y estado vital no existen en esta fuente y viajan en cobertura.noPublicados.

POST/api/identidad-pe1 crédito

Nombres y apellidos de una persona peruana a partir del DNI o del carné de extranjería (CE), contra el Portal Único del Conductor del MTC. El DNI se valida localmente —8 dígitos exactos— y el CE de 9 a 12; un documento imposible responde 400 sin cobrar. La consulta sale por una IP peruana (el portal responde 403 desde fuera de Perú) y respeta el límite de 1 llamada por segundo del registro; si la fuente no responde, el endpoint devuelve 502 source_error sin cobrar y no se sustituye por un padrón alternativo. El registro público solo publica nombres y apellidos: fecha de nacimiento, sexo e isAlive no existen en esta fuente y viajan en cobertura.noPublicados. Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)

{
  "documento": "00000000",
  "tipoDocumento": "DNI"
}

Parámetros del cuerpo de la solicitud
Campo	Tipo	Qué es
documentoobligatorio	string	DNI peruano de 8 dígitos o CE de 9 a 12, sin puntos ni espacios. Un largo distinto para el tipo elegido responde 400 sin cobrar. Alias aceptados: `dni`, `doc`.
tipoDocumento	string	`DNI` (default) o `CE` (carné de extranjería). Cualquier otro tipo responde 400 sin cobrar. Alias aceptados: `tipo`.
refresh	boolean	Ignora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).

Ejemplos por lenguaje

cURL

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"}'

JavaScript (fetch)

const res = await fetch("https://placapi.com/api/identidad-pe", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"documento":"00000000","tipoDocumento":"DNI"}),
});
const data = await res.json();

Python (requests)

import requests

res = requests.post(
    "https://placapi.com/api/identidad-pe",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"documento":"00000000","tipoDocumento":"DNI"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)

{
  "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-07-24T15:04:05.000Z",
  "cost": 1
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

Última revisión: 30 de octubre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.