Endpoint: licencia de conducir en Perú por documento

Devuelve el récord del conductor peruano a partir de su DNI o carné de extranjería, desde el registro oficial del Ministerio de Transportes: cada licencia con número, clase y categoría, estado (vigente, suspendida, cancelada), fechas de expedición y revalidación y restricciones, y las sanciones con resolución, fechas de inicio y fin y si siguen en curso. Un documento sin licencia responde tieneLicencia: false, que también es un resultado. No incluye nombre ni datos de la persona.

POST/api/licencia-pe1 crédito

Récord del conductor peruano por documento: licencias de conducir con número, clase y categoría, estado (VIGENTE o compuestos como CANCELADA/CONDUCTOR INHABILITADO), fechas de expedición y revalidación y restricciones, más las sanciones (resolución, fechas de inicio y fin, y estado derivado de esas fechas). No devuelve nombre ni datos de la persona: solo lo que describe la licencia. puntos llega siempre null: el registro no los publica. status es ok con licencia vigente, warn con cualquier otro estado o sanción vigente e info sin licencia. Un documento sin licencia es una respuesta válida (tieneLicencia: false) y cobra; un DNI que no tenga exactamente 8 dígitos responde 400 consulta_invalida sin cobrar. Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)
{
  "documento": "12345678"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
documentoobligatoriostringDNI (8 dígitos) o carné de extranjería del conductor. Alias aceptados: `dni`, `doc`.
tipoDocumentostring`DNI` (default, 8 dígitos) o `CE` (carné de extranjería, 9 dígitos).Valores: DNI · CE
refreshbooleanIgnora 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/licencia-pe' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"documento":"12345678"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/licencia-pe", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"documento":"12345678"}),
});
const data = await res.json();
Python (requests)
import requests

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

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)
{
  "source": "licencia",
  "status": "ok",
  "data": {
    "pais": "PE",
    "documento": "12345678",
    "tipoDocumento": "DNI",
    "tieneLicencia": true,
    "licencias": [
      {
        "numero": "AB0040865",
        "clase": "A",
        "categoria": "I",
        "estado": "VIGENTE",
        "fechaExpedicion": "2019-05-10",
        "fechaRevalidacion": "2029-05-10",
        "restricciones": "SIN RESTRICCIONES"
      }
    ],
    "sanciones": [],
    "puntos": null
  },
  "portalUrl": "https://recordconductor.mtc.gob.pe/",
  "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: 1 de septiembre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto