Endpoint: licencia de conducir en México (CDMX) por CURP

Devuelve la vigencia de la licencia de conducir de la Ciudad de México ligada a una CURP, desde el portal de finanzas de la CDMX. No es el registro nacional de licencias — México no tiene uno público —: cubre licencias emitidas en la Ciudad de México. La respuesta negativa del portal agrupa dos situaciones distintas que este endpoint conserva en el mensaje: sin datos registrados en CDMX o licencia permanente (el programa 2024+, que por diseño no tiene vigencia). Por eso encontrada: false no afirma que la persona no tenga licencia: solo que la ciudad no reporta una vigencia para esa CURP, y el mensaje del portal viaja completo para que el integrador lo distinga. Una CURP mal formada responde 400 sin cobrar; una CURP bien formada sin vigencia reportada es una respuesta válida y cobra.

POST/api/licencia-mx1 crédito

Vigencia de la licencia de conducir de la Ciudad de México por CURP, desde el portal de finanzas de la CDMX. Devuelve si el registro reporta vigencia para esa CURP y la vigencia tal como la publica el portal. ⚠️ No es el registro nacional de licencias — México no tiene uno público — y la respuesta negativa del portal agrupa dos cosas: sin datos en CDMX O licencia permanente (el programa 2024+, que no tiene vigencia). Por eso encontrada: false no afirma que la persona no tenga licencia: solo que la ciudad no reporta una vigencia, y el mensaje del portal viaja completo. Una CURP mal formada responde 400 sin cobrar. status es ok con vigencia reportada e info sin ella (respuesta válida que cobra). Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)
{
  "curp": "AAAA000000HDFXXX01"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
curpobligatoriostringCURP de 18 caracteres (4 letras, 6 dígitos, 1 letra y 7 alfanuméricos). Se aceptan espacios y guiones.
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-mx' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"curp":"AAAA000000HDFXXX01"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/licencia-mx", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"curp":"AAAA000000HDFXXX01"}),
});
const data = await res.json();
Python (requests)
import requests

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

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)
{
  "source": "licencia",
  "status": "ok",
  "data": {
    "pais": "MX",
    "curp": "AAAA000000HDFXXX01",
    "encontrada": true,
    "vigencia": "2027-05-10",
    "mensaje": null
  },
  "portalUrl": "https://data.finanzas.cdmx.gob.mx/consulta_adeudos",
  "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: 4 de septiembre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto