API de licencias de conducción de Colombia por documento

Name: PlacApi
Price: 499 COP

PlacApi expone una API REST para consultar las licencias de conducción de una persona en Colombia usando su tipo y número de documento. Devuelve en JSON el estado del conductor, cada licencia con sus categorías y vigencias, si está suspendida, las multas asociadas y el paz y salvo.

Probar en el sandbox y generar API key Ver precios por consulta

Qué problema resuelve

Validar la licencia de un conductor —para vincularlo a una flota, una app de movilidad o un seguro— exige consultar el RUNT ciudadano, que no ofrece API pública. PlacApi lo entrega como un endpoint REST por documento.

Para quién sirve

Apps de movilidad y última milla que verifican conductores, aseguradoras, empresas de transporte y flotas que exigen licencia vigente.

Datos requeridos

docType — tipo de documento (CC, CE…).
docNumber — número de documento de la persona.

Fuentes y cobertura

RUNT ciudadanoLicencias de conducción por persona: categorías, vigencias, estado, suspensiones, multas y paz y salvo.

Ejemplo de solicitud

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

curl -X POST 'https://placapi.com/api/licencia' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"docType":"CC","docNumber":"1020304050"}'

Ejemplo de respuesta

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

{
  "persona": {
    "documento": "1020304050",
    "nombres": "JUAN",
    "apellidos": "PÉREZ",
    "estadoConductor": "ACTIVO"
  },
  "licencias": [
    {
      "numeroLicencia": "1020304050",
      "organismoExpide": "INSTITUTO DE MOVILIDAD",
      "estado": "ACTIVA",
      "suspendida": false,
      "categorias": [
        {
          "categoria": "B1",
          "fechaVencimiento": "2035-04-23"
        }
      ]
    }
  ],
  "multas": {
    "tieneMultas": false,
    "pazYSalvo": "885466652067"
  },
  "vigente": true
}

Explicación campo por campo

Campo	Tipo	Descripción
persona.estadoConductor	string	Estado del conductor en el RUNT (ACTIVO, INACTIVO…).
licencias[].estado	string	Estado de cada licencia (ACTIVA, VENCIDA…).
licencias[].suspendida	boolean	true si la licencia está suspendida.
licencias[].categorias[]	array	Categorías (A1, B1, C1…) con su fecha de vencimiento.
multas.pazYSalvo	string	Número de paz y salvo cuando aplica.
vigente	boolean	true si al menos una licencia está vigente y sin suspensión.

Tiempo de respuesta

Entre 30 y 90 segundos la primera vez —es lo que tardan los portales oficiales en responder—. Reconsultar la misma placa es casi instantáneo porque el resultado queda en caché.

Precio y cobro

1 crédito por consulta con datos = 499 COP. Los créditos se compran por adelantado (mínimo 10 = 4.990 COP), no vencen y no hay mensualidad. El mismo precio aplica por API. Solo se cobra cuando la consulta devuelve datos.

Caché y actualización

El estado de una licencia cambia poco, así que se cachea por días; una suspensión o renovación reciente puede requerir refrescar.

Seguridad y privacidad

La placa y el documento se usan solo para ejecutar la consulta; el resultado queda en caché temporal. No se almacenan datos de tarjetas (los pagos los procesa Wompi). Ver privacidad y seguridad.

Limitaciones y posibles errores

La consulta es por persona (documento), no por placa.
Si el RUNT ciudadano no responde, la consulta devuelve error.
PlacApi reporta lo que el RUNT expone; no emite ni gestiona licencias.

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

Preguntas frecuentes

¿Se consulta por placa o por cédula?

Por documento de la persona. Las licencias son del conductor, no del vehículo.

¿Devuelve todas las categorías?

Sí: cada licencia lista sus categorías (A1, B1, C1…) con la fecha de vencimiento de cada una.

Seguir explorando

Última revisión: 11 de julio de 2026 · Versión de la API: v1 · Fuentes y metodología