API SOAT Colombia: consulta vigencia y aseguradora por placa
PlacApi expone una API REST para consultar el SOAT (Seguro Obligatorio de Accidentes de Tránsito) de un vehículo colombiano. Con la placa y el documento del propietario devuelve en JSON si el SOAT está vigente, la aseguradora, la fecha de vencimiento y los días que faltan para vencer, según lo que reporta el RUNT.
Qué problema resuelve
Saber si un carro tiene el SOAT al día es clave antes de comprarlo, renovarlo o asegurarlo, pero el dato vive en el RUNT detrás de captcha. Integrarlo en un recordatorio de vencimiento o un flujo de venta requiere una API estable.
Para quién sirve
Aseguradoras e intermediarios, apps de recordatorios de vencimiento, concesionarios y flotas que necesiten monitorear la vigencia del SOAT de muchos vehículos.
Datos requeridos
- placa — placa del vehículo.
- docType y docNumber — documento del propietario actual.
Fuentes y cobertura
- SOAT vía RUNTEl estado del SOAT se lee del RUNT: vigencia, entidad aseguradora y fecha de vencimiento.
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).
{
"soat": {
"status": "ok",
"data": {
"vigente": true,
"aseguradora": "SBS SEGUROS",
"fechaVencimiento": "2026-09-19",
"diasParaVencer": 71
}
}
}Explicación campo por campo
| Campo | Tipo | Descripción |
|---|---|---|
| soat.status | string | ok, empty o error. |
| soat.data.vigente | boolean | true si el SOAT está vigente. |
| soat.data.aseguradora | string | Entidad que expidió el SOAT. |
| soat.data.fechaVencimiento | string (ISO) | Fecha de vencimiento de la póliza. |
| soat.data.diasParaVencer | number | Días restantes hasta el vencimiento (negativo si ya venció). |
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
Un SOAT vigente se cachea por días; cuando faltan pocos días para vencer se refresca con más frecuencia para no dar un dato caduco.
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 SOAT recién pagado tarda algunas horas en reflejarse en el RUNT; hasta entonces puede aparecer vencido.
- Si el RUNT no responde, la fuente devuelve status error.
- PlacApi no vende SOAT ni es una aseguradora; solo reporta el estado que expone el RUNT.
Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.
Preguntas frecuentes
¿Por qué aparece vencido si lo acabo de pagar?
+
El pago tarda horas en reflejarse en el RUNT. Espera ~24 h y vuelve a consultar forzando refresco.
¿Puedo monitorear el SOAT de una flota?
+
Sí. Consulta cada placa periódicamente y usa diasParaVencer para disparar recordatorios de renovación.
Seguir explorando
Última revisión: 11 de julio de 2026 · Versión de la API: v1 · Fuentes y metodología