API de consulta vehicular de Colombia en una sola llamada REST
PlacApi es una API REST que, con la placa y el documento del propietario, devuelve en un solo JSON el resultado combinado de las fuentes vehiculares de Colombia: datos del RUNT, vigencia del SOAT y la tecnomecánica, multas del SIMIT, antecedentes, impuesto vehicular, valor FASECOLDA y reglas de pico y placa. Cada fuente reporta su propio estado, así que sabes exactamente cuál respondió y cuál no.
Qué problema resuelve
Para verificar un vehículo colombiano hay que abrir cinco a siete portales oficiales distintos (RUNT, SIMIT, FASECOLDA, secretarías de hacienda, secretarías de movilidad), resolver captchas y unir los datos a mano. Automatizar eso desde un producto propio es frágil. PlacApi expone ese trabajo como un único endpoint estable.
Para quién sirve
Concesionarios y plataformas de compraventa de usados, aseguradoras e intermediarios, administradores de flota, fintechs de crédito vehicular y cualquier desarrollador que necesite verificar un carro o moto desde su backend.
Datos requeridos
- placa — la placa del vehículo (carro o moto).
- docType — tipo de documento del propietario (CC, CE, NIT, etc.).
- docNumber — número de documento del propietario actual (el RUNT exige placa + documento).
Fuentes y cobertura
- RUNTMarca, línea, modelo, cilindraje, servicio, clase, motor, chasis y estado del registro.
- SOATVigencia, aseguradora y fecha de vencimiento del seguro obligatorio.
- Tecnomecánica (RTM)Vigencia y CDA expedidor de la revisión técnico-mecánica.
- SIMITMultas y comparendos asociados a la placa y su valor.
- AntecedentesPrendas, embargos e histórico de propietarios cuando la fuente lo expone.
- FASECOLDAValor comercial de referencia por marca, línea y modelo.
- Impuesto vehicularSaldo pendiente por año según la secretaría de hacienda departamental.
- Pico y placaSi aplica hoy en las principales ciudades según la placa.
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,
"clase": "CAMIONETA",
"estado": "activo"
}
},
"soat": {
"status": "ok",
"data": {
"vigente": true,
"aseguradora": "SBS SEGUROS",
"fechaVencimiento": "2026-09-19",
"diasParaVencer": 71
}
},
"rtm": {
"status": "ok",
"data": {
"vigente": true,
"exento": false,
"fechaVencimiento": "2026-09-22"
}
},
"antecedentes": {
"status": "ok",
"data": {
"prendas": 0,
"embargos": 0,
"historicoPropietarios": 2
}
},
"simit": {
"status": "ok",
"data": {
"tieneMultas": false,
"totalDeuda": 0
}
},
"impuestos": {
"status": "ok",
"data": {
"alDia": true,
"saldoPendiente": 0
}
},
"fasecolda": {
"status": "ok",
"data": {
"valor": 78500000,
"moneda": "COP"
}
},
"picoYPlaca": {
"status": "ok",
"data": {
"hoyAplica": false
}
}
}Explicación campo por campo
| Campo | Tipo | Descripción |
|---|---|---|
| vehicle.data | object | Ficha del RUNT: marca, línea, modelo, clase y estado del registro. |
| soat.data.vigente | boolean | true si el SOAT está vigente según el RUNT. |
| rtm.data.fechaVencimiento | string (ISO) | Fecha de vencimiento de la tecnomecánica. |
| simit.data.totalDeuda | number (COP) | Suma de multas y comparendos pendientes en el SIMIT. |
| fasecolda.data.valor | number (COP) | Valor comercial de referencia FASECOLDA. |
| *.status | string | Estado por fuente: ok, empty (sin datos) o error (la fuente no respondió). |
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
Los datos que no cambian a diario (SOAT vigente, ficha del RUNT) se cachean por días; los que están por vencer se refrescan con más frecuencia. Puedes forzar refresco por fuente.
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
- El resultado depende de la disponibilidad de cada portal oficial; una fuente caída se reporta con status error, no inventamos datos.
- El RUNT exige placa + documento del propietario actual; sin el documento correcto varias fuentes vienen vacías.
- PlacApi consolida información pública; no es una entidad oficial del Gobierno de Colombia.
Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.
Preguntas frecuentes
¿Consulta carros y motos?
+
Sí. Las motos están en el RUNT igual que los carros y devuelven SOAT, tecnomecánica (desde el segundo año), multas y valor FASECOLDA.
¿Puedo pedir solo algunas fuentes?
+
Sí. El endpoint acepta seleccionar el subconjunto de fuentes que necesitas para reducir tiempo y no pagar por lo que no usas.
¿Qué pasa si una fuente falla?
+
Esa fuente devuelve status error y el resto del JSON llega normal. Solo se cobra el crédito cuando la consulta trae datos del vehículo.
Seguir explorando
Última revisión: 11 de julio de 2026 · Versión de la API: v1 · Fuentes y metodología