API SIMIT Colombia: consulta multas y comparendos por placa
PlacApi (placapi.com) ofrece una API REST para consultar el SIMIT, el Sistema Integrado de Información sobre Multas y Sanciones por Infracciones de Tránsito de Colombia. Con la placa y el documento del propietario, el endpoint /api/multas devuelve en JSON, en unos 3 segundos, el total adeudado, cuántas multas hay y el detalle de cada comparendo: fecha, organismo, infracción con su código, valor, estado, si ya pasó a resolución y a quién está asociado: a la persona del documento o solo a la placa. Cuesta 1 crédito por consulta con datos, desde 349 COP y sin mensualidad.
¿No eres desarrollador? Consulta el RUNT por placa aquí sin escribir código.
Qué problema resuelve
Las multas del SIMIT se asocian a la placa e impiden trámites como el traspaso. Revisarlas a mano, placa por placa, no escala ni se integra con un CRM o un flujo de compraventa. Este endpoint dedicado lo resuelve por llamada y devuelve JSON estructurado.
Para quién sirve
Compraventas de usados que validan multas antes del traspaso, gestores de trámites, flotas que controlan comparendos de sus conductores y fintechs de crédito.
Datos requeridos
- placa — placa del vehículo.
- docType y docNumber — documento del propietario.
Fuentes y cobertura
- SIMIT (Federación Colombiana de Municipios)Multas y comparendos registrados a nombre de la placa, su estado y su valor pendiente.
¿Qué API sirve para consultar multas y comparendos del SIMIT por placa?
PlacApi tiene un endpoint dedicado: POST /api/multas. Recibe la placa y el tipo y número de documento del propietario, une las multas del vehículo con las de esa persona (también las de sus otras placas) sin repetir ninguna, y responde con totalDeuda en pesos, totalMultas, acuerdosPago y la lista multas, donde cada elemento trae comparendoId, fecha, organismo, infraccion, codigo, valor, estado (pendiente, acuerdo o pagada), placa (la placa a la que está asociada la multa), tipo (comparendo si sigue vigente, resolucion si ya escaló a sanción) y dos campos que dicen a quién está asociada: asociadaDocumento (false cuando la multa sale solo por la placa y es de otro infractor) y asociadaPlaca (false cuando es de esa persona en otro vehículo). El campo status resume el hallazgo para no tener que recorrer la lista: ok sin multas, warn con multas y danger cuando la deuda pasa de $1.000.000. En producción responde con una mediana de 2,4 segundos y un percentil 90 de 3,2 segundos, medidos entre el 15 de agosto y el 14 de septiembre de 2026, así que cabe dentro de una petición web mientras el usuario espera.
La llamada lleva la API key en el header x-api-key, y esa misma clave y el mismo saldo sirven para el resto del catálogo: RUNT, SOAT, tecnomecánica, avalúo FASECOLDA, impuesto vehicular y licencias de conducción. El contrato se prueba en el sandbox de /integracion y se descarga como OpenAPI o como colección de Postman: integrarlo no empieza por agendar una llamada comercial.
¿Qué más del SIMIT se puede consultar por API?
El SIMIT no responde una sola pregunta, y por eso PlacApi lo publica en ocho endpoints, cada uno con su contrato. Por placa y documento, /api/multas consolida la deuda del vehículo y la de su propietario, y marca en cada multa a cuál de los dos pertenece. Por documento de la persona, los otros siete responden por el conductor: sus comparendos, uno puntual por su número, las resoluciones sancionatorias, los acuerdos de pago con su saldo, el estado de cuenta que junta esos tres bloques en una respuesta, el paz y salvo y la suspensión o cancelación de la licencia de conducción.
Todos cuestan 1 crédito por consulta con datos, salvo el estado de cuenta, que cuesta 2 y reemplaza tres consultas; comparten API key y saldo, y la mediana medida en producción está entre 2,3 y 2,4 segundos en los seis que tuvieron tráfico en el último mes. Separarlos no es fragmentar el producto: una compraventa necesita la deuda de la placa antes del traspaso, una flota el paz y salvo de sus conductores y una agencia de trámites de licencias la suspensión, y ninguno debería pagar ni leer la respuesta de los otros.
| Endpoint | Se consulta con | Responde |
|---|---|---|
| /api/multas | Placa + documento del propietario | Deuda total de la placa y detalle de cada multa, con su tipo y a quién está asociada |
| /api/comparendos | Documento de la persona | Comparendos a su nombre, con organismo y departamento |
| /api/comparendo | Documento + número de comparendo | Un comparendo puntual, o encontrado: false si no figura |
| /api/resoluciones | Documento de la persona | Multas que ya tienen resolución sancionatoria |
| /api/acuerdos-pago | Documento de la persona | Acuerdos de pago con valor, saldo pendiente y secretaría |
| /api/estado-cuenta-transito | Documento de la persona | Comparendos, resoluciones y acuerdos de pago en una sola respuesta, con el total adeudado |
| /api/paz-salvo | Documento de la persona | Si está a paz y salvo, cuánto debe y cuántos comparendos tiene |
| /api/suspension-licencia | Documento de la persona | Si la licencia está suspendida o cancelada, desde y hasta cuándo, y quién la impuso |
¿El SIMIT tiene una API oficial para empresas?
No. La Federación Colombiana de Municipios, que administra el SIMIT, no ofrece una API abierta a empresas y desarrolladores para consultar desde un software la deuda de una placa o de una persona. PlacApi es un servicio independiente —no es la Federación ni tiene vínculo con ella— que consulta el SIMIT y entrega la respuesta normalizada en JSON, con el mismo contrato aunque el sistema oficial cambie por dentro. Reporta lo que el SIMIT publica en el momento de la consulta: no cobra, no gestiona ni descuenta multas.
¿Cuánto cuesta consultar el SIMIT por API?
1 crédito por consulta con datos: 349 COP en el tramo de entrada y hasta 99 COP por volumen, sin mensualidad y con créditos que no vencen. Una placa sin multas también cobra, porque «no debe nada» es el dato que se vino a buscar; reconsultarla mientras está en caché no cobra, y si el SIMIT no responde se devuelve el crédito reservado.
¿Se puede consultar el SIMIT por cédula en lugar de por placa?
Sí, con otro endpoint. /api/multas es por placa y documento del propietario, y responde por el vehículo y su propietario: cada multa dice si es de la persona o solo de la placa. /api/comparendos es por tipo y número de documento, y responde por la persona: los comparendos a su nombre, sin importar con qué vehículo los cometió. Para controlar a los conductores de una flota, el segundo es el que sirve.
Ejemplo de solicitud
POST https://placapi.com/api/multas. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.
curl -X POST 'https://placapi.com/api/multas' \
-H 'x-api-key: pk_live_TU_CLAVE' \
-H 'content-type: application/json' \
-d '{"placa":"ABC123","docType":"CC","docNumber":"1020304050"}'Parámetros, errores y ejemplos en cURL, JavaScript y Python: documentación de POST /api/multas.
Ejemplo de respuesta
Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).
{
"source": "multas",
"status": "warn",
"data": {
"totalDeuda": 522700,
"totalMultas": 1,
"multas": [
{
"comparendoId": "11001000000012345678",
"fecha": "2025-03-15",
"organismo": "SECRETARÍA DISTRITAL DE MOVILIDAD DE BOGOTÁ",
"infraccion": "No respetar pico y placa",
"codigo": "C14",
"estado": "pendiente",
"valor": 522700,
"tipo": "comparendo",
"placa": "ABC123",
"asociadaDocumento": true,
"asociadaPlaca": true
}
],
"acuerdosPago": 0
},
"mode": "live",
"fetchedAt": "2026-09-14T15:04:05.000Z"
}Explicación campo por campo
| Campo | Tipo | Descripción |
|---|---|---|
| source | string | Qué dato es; siempre "multas". |
| status | string | ok sin deuda, warn con deuda (multas o acuerdos de pago pendientes) y danger si la deuda pasa de $1.000.000. Califica el hallazgo, no la llamada. |
| data.totalDeuda | number (COP) | Suma pendiente de la placa y del documento, sin contar dos veces la misma multa. Incluye a propósito los comparendos vigentes y las multas que ya pasaron a resolución. |
| data.totalMultas | number | Cantidad de multas encontradas. |
| data.multas[] | array | Una entrada por multa: comparendoId, fecha, organismo, infraccion, codigo, valor, estado, tipo, placa, asociadaDocumento y asociadaPlaca. |
| data.multas[].placa | string | Placa a la que el SIMIT asocia la multa. Si no es la consultada, es deuda de la persona del documento en otro de sus vehículos. |
| data.multas[].asociadaDocumento | boolean | null | true si la persona del documento es la infractora; false si la multa sale solo por la placa (otro conductor, un dueño anterior). null si no se consultó documento. |
| data.multas[].asociadaPlaca | boolean | null | true si la multa es de la placa consultada; false si es de la persona del documento en otro vehículo. null si no se consultó placa. |
| data.multas[].codigo | string | Código de la infracción, por ejemplo C14. |
| data.multas[].estado | string | pendiente, acuerdo o pagada. |
| data.multas[].tipo | string | comparendo si la multa sigue vigente; resolucion si ya escaló a sanción con número de resolución. |
| data.multas[].valor | number (COP) | Valor de la multa. |
| data.acuerdosPago | number | Cantidad de acuerdos de pago sobre la deuda. |
| mode | string | live = dato real de la fuente oficial (no demo); si salió del caché lo dice fromCache: true y fetchedAt es el momento de la consulta original. |
| fetchedAt | string (ISO 8601) | Instante en que se obtuvo el dato. |
Tiempo de respuesta
Unos 3 segundos: en producción, mediana de 2,4 s y percentil 90 de 3,2 s entre el 15 de agosto y el 14 de septiembre de 2026, sin contar las respuestas de caché. Una placa ya consultada responde al instante mientras siga en caché, y esa respuesta no cobra.
Precio y cobro
1 crédito por consulta con datos, desde 349 COP. El precio por crédito baja por volumen: 349 COP desde 30, 249 COP desde 1.000, 149 COP desde 5.000, 139 COP desde 10.000, 119 COP desde 20.000, 99 COP desde 50.000. Los créditos se compran por adelantado (mínimo 30 = 10.470 COP), no vencen y no hay mensualidad. Por la web, el informe completo por placa cuesta 3 créditos. Solo se cobra cuando la consulta devuelve datos; por API, las consultas sin resultado (404) tienen 10 gratis al mes por cada tipo de respuesta sin datos y después cobran igual.
Caché y actualización
Las multas cambian con pagos y comparendos nuevos: una consulta con datos queda en caché 24 horas, y repetirla en ese lapso responde al instante y no cobra. Antes de un traspaso conviene pedirla con refresh en true, que vuelve a preguntarle al SIMIT y, si trae datos, cobra.
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
- Las multas se asocian a la placa, no al conductor del momento; una multa no significa que el dueño actual la haya causado.
- El SIMIT puede tardar en reflejar pagos recientes.
- PlacApi no cobra ni gestiona multas; solo reporta lo que el SIMIT publica.
- El detalle por comparendo depende de lo que el SIMIT exponga en el momento de la consulta.
Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.
Otras preguntas frecuentes
¿Cómo consultar el SIMIT por API?
+
Con una llamada POST a /api/multas que lleve la placa y el tipo y número de documento del propietario, con la API key en el header x-api-key. La respuesta trae en JSON el total adeudado y el detalle de cada multa, con su código, su estado, su organismo de tránsito y si está asociada al documento o solo a la placa. Para el desglose por persona hay endpoints dedicados: comparendos, detalle de comparendo, resoluciones, acuerdos de pago, paz y salvo y suspensión de licencia.
¿Aparece una multa que no es mía?
+
El SIMIT asocia comparendos a la placa. Si tu carro tiene una multa que no causaste, el proceso de impugnación se hace ante el organismo de tránsito; PlacApi solo la reporta.
¿Qué diferencia hay entre comparendo y resolución en la respuesta?
+
Lo dice el campo tipo de cada multa. comparendo es una infracción todavía vigente; resolucion es una que ya escaló a sanción y tiene número de resolución. totalDeuda suma las dos a propósito, porque las dos se deben; si solo interesan los comparendos vigentes de una persona, está /api/comparendos.
¿Devuelve el detalle de cada comparendo?
+
Sí: cada elemento de data.multas trae comparendoId, fecha, organismo, infraccion, codigo, valor, estado, tipo, placa, asociadaDocumento y asociadaPlaca. Los dos últimos importan porque la respuesta une la deuda del vehículo con la del documento: asociadaDocumento en false es una multa que sale solo por la placa, de otro infractor, y asociadaPlaca en false es de la misma persona en otro vehículo. Para buscar un comparendo puntual por su número está /api/comparendo, que responde encontrado: false cuando no figura.
¿Este endpoint también trae el RUNT o el SOAT?
+
No. /api/multas devuelve solo el SIMIT. La ficha del RUNT, el SOAT y la tecnomecánica están en /api/consulta; impuestos, avalúo y pico y placa tienen sus propios endpoints.
Seguir explorando
- API de comparendos por cédula
- API de licencias de conducción: verifica conductores
- API de consulta full: multas, RUNT, impuesto y avalúo en una llamada
- API FASECOLDA: valor comercial por placa
- Documentación del endpoint POST /api/multas
- API de antecedentes judiciales por cédula
- Verificar un usado antes de comprar
- API de consulta vehicular (ficha RUNT)
- API de impuesto vehicular
- API RUNT
- Fuentes y metodología
- Precios por consulta
- API del RUES: registro mercantil
- API del SECOP II: contratos con el Estado
- API de antecedentes disciplinarios
- Consulta masiva de placas por API
- Papeletas por placa en Perú: SUTRAN y SAT de Lima
- Multas de tránsito en Chile por patente: los tres registros
Última revisión: 14 de septiembre de 2026 · Versión de la API: v1 · Fuentes y metodología