API RUNT Colombia: consulta la ficha del vehículo por placa vía REST
PlacApi permite consultar el Registro Único Nacional de Tránsito (RUNT) de Colombia desde un backend mediante una API REST. Con la placa y el documento del propietario devuelve en JSON los datos disponibles de la ficha del vehículo —marca, línea, modelo, cilindraje, servicio, clase, motor, chasis y estado del registro— junto con el estado de las demás fuentes configuradas.
Qué problema resuelve
El portal del RUNT (runt.gov.co) exige captcha y no ofrece una API pública para desarrolladores. Integrar la ficha de un vehículo en un CRM, un flujo de compraventa o un score de crédito obliga a scrapear un sitio inestable. PlacApi encapsula esa consulta en un endpoint REST estable.
Para quién sirve
Concesionarios, plataformas de usados, talleres, aseguradoras y fintechs que necesiten la ficha técnica y el estado del RUNT de un vehículo colombiano dentro de su propio software.
Datos requeridos
- placa — placa del vehículo.
- docType — tipo de documento del propietario (CC, CE, NIT…).
- docNumber — número de documento del propietario actual, exigido por el RUNT.
Fuentes y cobertura
- RUNT (runt.gov.co)Ficha del vehículo: marca, línea, modelo, cilindraje, combustible, servicio, clase, motor, chasis, VIN, organismo y estado del registro.
Ejemplo de solicitud
POST https://placapi.com/api/consulta. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.
curl -X POST 'https://placapi.com/api/consulta' \
-H 'x-api-key: pk_live_TU_CLAVE' \
-H 'content-type: application/json' \
-d '{"placa":"ABC123","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).
{
"vehicle": {
"source": "RUNT",
"status": "ok",
"data": {
"placa": "ABC123",
"marca": "MAZDA",
"linea": "CX-30",
"modelo": 2023,
"cilindraje": 2000,
"combustible": "GASOLINA",
"servicio": "PARTICULAR",
"clase": "CAMIONETA",
"estado": "activo"
}
}
}Explicación campo por campo
| Campo | Tipo | Descripción |
|---|---|---|
| vehicle.source | string | Fuente del bloque, aquí "RUNT". |
| vehicle.status | string | ok, empty o error según la respuesta del RUNT. |
| vehicle.data.marca / linea / modelo | string / number | Identificación comercial del vehículo. |
| vehicle.data.cilindraje | number (cc) | Cilindraje del motor. |
| vehicle.data.servicio / clase | string | PARTICULAR/PÚBLICO y clase (AUTOMÓVIL, CAMIONETA, MOTO…). |
| vehicle.data.estado | string | Estado del registro en el RUNT (p. ej. activo). |
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
La ficha del RUNT cambia poco, así que se cachea por días. Un traspaso reciente puede tardar en reflejarse; puedes forzar un refresco.
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
- Sin el documento del propietario actual el RUNT no devuelve la ficha completa.
- Si runt.gov.co está en mantenimiento, la consulta devuelve status error para esta fuente.
- PlacApi no es el RUNT ni una entidad oficial; consolida lo que el RUNT expone públicamente.
Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.
Preguntas frecuentes
¿Necesito el documento del dueño para consultar el RUNT?
+
Sí. Es una medida de privacidad del Estado: se requiere placa + número de documento del propietario actual.
¿Devuelve motor y chasis?
+
Cuando el RUNT los expone, sí. Útil para validar que coincidan con la tarjeta de propiedad antes de comprar.
Seguir explorando
Última revisión: 11 de julio de 2026 · Versión de la API: v1 · Fuentes y metodología