Respuesta corta: Para hacer una consulta RUNT por placa por API en Colombia, envía GET https://api.verifik.co/v2/co/runt/vehicle-by-plate-only con un solo parámetro, plate, y tu token Bearer. No necesitas el documento del propietario. Verifik responde en JSON firmado con el estado del vehículo, SOAT, revisión técnico-mecánica (RTM), prendas, gravámenes, limitaciones y trámites del RUNT. Puedes probarlo gratis en sandbox con la placa AA123BA y luego pagar con créditos de smartCHECK desde $49 al mes. Actualizado: noviembre de 2026.
Varias consultas del RUNT por API, incluidos algunos endpoints de Verifik, piden la placa y además el tipo y número de documento del propietario. En un onboarding, una cotización de seguro o la publicación de un carro usado, ese dato casi nunca lo tienes. El endpoint RUNT – Registros de vehículos solo por placa de Verifik resuelve eso: con 1 parámetro (la placa) obtienes el registro del vehículo en el RUNT, con información general, datos técnicos, pólizas SOAT, revisión técnico-mecánica, garantías, limitaciones y solicitudes.
En esta guía verás qué devuelve la consulta, cómo llamarla con el ejemplo oficial de la documentación, en qué se diferencia de los otros endpoints vehiculares de Verifik para Colombia, qué reglas de negocio puedes automatizar y cuánto cuesta.
Qué devuelve la consulta RUNT por placa API de Verifik
La respuesta trae un objeto data con 12 bloques de información del vehículo, además de plate y vin. Estos son los que documenta Verifik:
informacionGeneral: marca, línea, modelo, color, clase y tipo de carrocería, combustible, tipo de servicio, cilindraje (el campo se llamacilidraje), puertas, números de motor, chasis y VIN, licencia de tránsito, fecha de matrícula, organismo de tránsito,estadoDelVehiculo,prendas,tieneGravamenesyrepotenciado.datosTecnicos: número de ejes, pasajeros sentados y peso bruto vehicular.soat: pólizas con aseguradora, número de póliza, estado (por ejemplo “VIGENTE”), fechas de expedición, vigencia y vencimiento, y tipo de tarifa.tecnoMecanica: indica si la revisión técnico-mecánica está vigente ("vigente": "SI").solicitudes: trámites ante el organismo de tránsito con entidad, estado, fecha, número de solicitud y trámite realizado.- Garantías y limitaciones:
garantiasMobiliarias,garantiasFavorDe,limitacionPropiedadynormalizacionSaneamiento. - Otros bloques:
polizasResponsabilidadCivil,informacionBlindajeytarjetaOperacion. - Firma: un objeto
signaturecon fecha y hora y el mensaje “Certified by Verifik.co”, útil como evidencia de cada consulta, y unidde la respuesta.
La documentación aclara dos detalles: un arreglo u objeto vacío significa que el RUNT no tiene filas para esa sección, y documentType y documentNumber pueden venir en null porque este endpoint no recibe datos del propietario.
Puedes probar lo que explica esta guía sobre consulta RUNT por placa API en tu propia cuenta: crea una cuenta en Verifik.
Por qué hacer la consulta RUNT por placa por API y no a mano en 2026
Según el sitio oficial del RUNT, el parque automotor registrado era de 22.476.551 vehículos al 1 de agosto de 2026. El RUNT ofrece una consulta de vehículos por placa para que los ciudadanos conozcan la información que reposa en el sistema sobre su vehículo. Y el control importa: en su Boletín de prensa 002 de 2026 (8 de mayo de 2026), el RUNT informó que más de 10 millones de vehículos en Colombia no tienen vigente la revisión técnico-mecánica. Si tu operación revisa decenas o miles de placas al mes, la API de Verifik te entrega el registro del vehículo en JSON, lista para tus reglas de negocio:
- Fintech y créditos con garantía vehicular: confirmar que el vehículo está activo y sin prendas ni gravámenes antes de desembolsar.
- Aseguradoras: leer marca, línea, modelo, servicio y SOAT vigente para cotizar sin pedir papeles.
- Rentadoras y flotas: vigilar el vencimiento del SOAT y la revisión técnico-mecánica de cada vehículo. Si necesitas controlar esas fechas en toda una flota, mira nuestra guía de la API de consulta SOAT y tecnomecánica.
- Marketplaces de carros usados: validar que la placa publicada corresponde a la marca y el modelo del anuncio.
Cómo hacer la consulta RUNT por placa por API: endpoint, código y respuesta
Solo necesitas tu token de Verifik (encabezado Authorization: Bearer) y 1 parámetro obligatorio:
plate: la placa del vehículo, de 5 a 9 caracteres alfanuméricos (por ejemploAA123BA).
Ejemplo con cURL
curl -G "https://api.verifik.co/v2/co/runt/vehicle-by-plate-only" \
-H "Accept: application/json" \
-H "Authorization: Bearer $VERIFIK_TOKEN" \
--data-urlencode "plate=AA123BA"Ejemplo en Node.js
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/runt/vehicle-by-plate-only", {
params: { plate: "AA123BA" },
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);Ejemplo en Python
Este es el ejemplo en Python tomado de la documentación del endpoint:
import os, requests
url = "https://api.verifik.co/v2/co/runt/vehicle-by-plate-only"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
response = requests.get(url, headers=headers, params={"plate": "AA123BA"})
print(response.json())Respuesta de ejemplo
Y esta es una versión resumida de la respuesta 200 de ejemplo de la documentación (omitimos algunos campos de informacionGeneral y los bloques vacíos):
{
"data": {
"informacionGeneral": {
"claseVehiculo": "AUTOMOVIL",
"estadoDelVehiculo": "ACTIVO",
"fechaMatricula": "15/03/2018",
"linea": "COROLLA",
"marca": "TOYOTA",
"modelo": "2020",
"noPlaca": "AA123BA",
"organismoTransito": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA",
"prendas": "NO",
"tieneGravamenes": "NO",
"tipoServicio": "Particular"
},
"soat": [
{
"entidadExpideSoat": "SEGUROS DEL ESTADO S.A.",
"estado": "VIGENTE",
"fechaVencimiento": "31/12/2024",
"noPoliza": "SOAT-000001"
}
],
"tecnoMecanica": [
{
"vigente": "SI"
}
],
"limitacionPropiedad": [],
"plate": "AA123BA",
"vin": "9FB10000001"
},
"signature": {
"dateTime": "September 16, 2026 8:00 PM",
"message": "Certified by Verifik.co"
},
"id": "ABCDE"
}Códigos de respuesta que debes manejar
| Código | Qué significa | Qué hacer |
|---|---|---|
| 200 | Consulta exitosa | Aplica tus reglas y guarda id y signature |
| 404 | {"code": "NotFound", "message": "Record not found."}: la placa no tiene registro | Revisa la placa con el cliente; no reintentes |
| 409 | Falta la placa ("missing plate") o es inválida | Corrige el parámetro antes de reenviar |
| 409 (no disponible) | El servicio no está disponible temporalmente (Endpoint_out_of_service) | Reintenta más tarde con espera |
Las fechas llegan como texto en formato día/mes/año.
¿Quieres probarlo? Crea tu cuenta gratis en Verifik y usa en sandbox la placa AA123BA o las placas ABC10001 a ABC10010, que devuelven respuestas 200 estables. La placa ERR40401 devuelve un 404 para probar tu manejo de errores.
Qué endpoint vehicular de Verifik usar en Colombia
Verifik tiene varios endpoints del RUNT por placa. La diferencia principal es qué datos pides y qué te devuelven:
| Endpoint | Qué pide | Qué devuelve |
|---|---|---|
/v2/co/runt/vehicle-by-plate-only | Solo la placa | Registro del vehículo: SOAT, revisión técnico-mecánica, garantías, limitaciones y solicitudes |
/v2/co/runt/propietarios | Solo la placa | Datos básicos del vehículo y registros de propiedad |
/v2/co/runt/vehicle-by-plate | Placa, tipo y número de documento | Registro completo del vehículo con historial |
/v2/co/runt/vehicle-by-plate-simplified | Placa, tipo y número de documento | Datos esenciales del vehículo, sin historial de seguros ni de revisión técnico-mecánica |
Si necesitas saber quién figura como dueño, revisa nuestra guía para consultar el propietario de un vehículo por placa en Colombia con API. Puedes combinar los dos endpoints: primero el registro del vehículo y luego los propietarios, ambos solo con la placa.
Consulta RUNT por placa para conductores, flotas y onboarding KYC
La consulta por placa casi nunca va sola. Estos son los flujos más comunes en los que se combina con otras consultas de Verifik:
- Logística y reparto: antes de asignar un despacho, valida al conductor (identidad, licencia, SIMIT y antecedentes) y al vehículo por placa. Nuestra guía para verificar conductores en Colombia por API muestra el flujo completo en 6 pasos, con código.
- Flotas y rentadoras: repite la consulta cada mes para anticipar vencimientos. Si solo necesitas fechas de SOAT y RTM, la API de consulta SOAT y tecnomecánica es más directa.
- Créditos y compraventa: confirma el estado y los gravámenes por placa y luego quién figura como dueño con la consulta de propietario por placa.
- Onboarding de clientes: cuando además debes verificar a la persona (cédula, biometría, antecedentes o listas), la guía de API KYC para Colombia reúne esos endpoints.
Reglas de negocio que puedes automatizar con la respuesta
Con los campos de la respuesta puedes armar reglas simples de aprobación o revisión. El diagrama resume los 6 controles y la lista los detalla:

- Estado del vehículo: si
estadoDelVehiculono es “ACTIVO”, envía el caso a revisión. - Prendas y gravámenes: si
prendasotieneGravamenesno es “NO”, o sigarantiasMobiliariastrae filas, valida la deuda antes de aceptar el vehículo como garantía. - Limitaciones: si
limitacionPropiedadno viene vacío, detén la operación hasta revisar el detalle. - SOAT y revisión técnico-mecánica: compara la
fechaVencimientodel SOAT con la fecha de hoy y verifica quetecnoMecanicaindique"vigente": "SI". - Coherencia del anuncio: compara
marca,linea,modeloytipoServiciocon lo que declaró el cliente. - Evidencia: guarda el
idy lasignaturede cada respuesta en el expediente.
Así se ven esas reglas en Python, con el manejo de 404 y 409:
import os, requests
def consulta_runt_por_placa(placa):
r = requests.get(
"https://api.verifik.co/v2/co/runt/vehicle-by-plate-only",
headers={"Accept": "application/json",
"Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"},
params={"plate": placa},
timeout=60,
)
if r.status_code == 404:
return {"decision": "rechazar", "motivo": "placa sin registro en el RUNT"}
if r.status_code == 409:
return {"decision": "reintentar", "motivo": r.json().get("message")}
r.raise_for_status()
d = r.json()["data"]
g = d.get("informacionGeneral", {})
alertas = []
if g.get("estadoDelVehiculo") != "ACTIVO":
alertas.append("vehículo no activo")
if g.get("prendas") != "NO" or g.get("tieneGravamenes") != "NO":
alertas.append("prendas o gravámenes")
if d.get("limitacionPropiedad"):
alertas.append("limitaciones de propiedad")
if not any(s.get("estado") == "VIGENTE" for s in d.get("soat", [])):
alertas.append("SOAT no vigente")
if not any(t.get("vigente") == "SI" for t in d.get("tecnoMecanica", [])):
alertas.append("RTM no vigente")
return {"decision": "revisar" if alertas else "aprobar",
"alertas": alertas, "evidencia": r.json().get("id")}
print(consulta_runt_por_placa("AA123BA"))Si el RUNT muestra un dato que el cliente considera errado, el RUNT indica que los organismos de tránsito son las entidades competentes para modificar la información registrada. Las normas del sector las publica el Ministerio de Transporte.
Para un análisis más completo, suma otras consultas de Verifik: el historial completo del vehículo en el RUNT, la validación simplificada de datos vehiculares por placa, las multas de tránsito en el SIMIT y las reclamaciones de seguros del vehículo.
Cuánto cuesta la consulta RUNT por placa API con Verifik
Verifik no cobra una suscripción por endpoint: cada consulta se descuenta de los créditos de tu plan de smartCHECK. Según la página de precios de smartCHECK:
- Starter: $49 al mes, o $490 al año recibiendo $588 en créditos.
- Basic: $129 al mes, o $1.290 al año recibiendo $1.548 en créditos.
- Plus: $299 al mes, o $2.990 al año recibiendo $3.588 en créditos.
- Business: $649 al mes, o $6.490 al año recibiendo $7.788 en créditos.
Los planes anuales incluyen 2 meses gratis. El costo de cada llamada a /v2/co/runt/vehicle-by-plate-only se descuenta de tus créditos y lo ves en tu panel al crear la cuenta.
Empieza tu consulta RUNT por placa por API hoy
Con solo la placa puedes saber si un vehículo está activo, si tiene SOAT y revisión técnico-mecánica vigentes y si arrastra prendas o limitaciones, con un registro firmado de cada consulta. Revisa la documentación del endpoint y haz tu primera llamada en el sandbox.
¿Listo para empezar? Crea tu cuenta gratis en Verifik o agenda una demo para ver cómo integrar la verificación de vehículos en tu flujo de crédito, seguros o alquiler.




