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.

Los ocho endpoints del SIMIT en PlacApi (1 crédito por consulta con datos; el estado de cuenta, 2)
EndpointSe consulta conResponde
/api/multasPlaca + documento del propietarioDeuda total de la placa y detalle de cada multa, con su tipo y a quién está asociada
/api/comparendosDocumento de la personaComparendos a su nombre, con organismo y departamento
/api/comparendoDocumento + número de comparendoUn comparendo puntual, o encontrado: false si no figura
/api/resolucionesDocumento de la personaMultas que ya tienen resolución sancionatoria
/api/acuerdos-pagoDocumento de la personaAcuerdos de pago con valor, saldo pendiente y secretaría
/api/estado-cuenta-transitoDocumento de la personaComparendos, resoluciones y acuerdos de pago en una sola respuesta, con el total adeudado
/api/paz-salvoDocumento de la personaSi está a paz y salvo, cuánto debe y cuántos comparendos tiene
/api/suspension-licenciaDocumento de la personaSi 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.

Ejemplo cURL de la solicitud
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).

Ejemplo de respuesta JSON
{
  "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

CampoTipoDescripción
sourcestringQué dato es; siempre "multas".
statusstringok 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.totalDeudanumber (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.totalMultasnumberCantidad de multas encontradas.
data.multas[]arrayUna entrada por multa: comparendoId, fecha, organismo, infraccion, codigo, valor, estado, tipo, placa, asociadaDocumento y asociadaPlaca.
data.multas[].placastringPlaca 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[].asociadaDocumentoboolean | nulltrue 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[].asociadaPlacaboolean | nulltrue 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[].codigostringCódigo de la infracción, por ejemplo C14.
data.multas[].estadostringpendiente, acuerdo o pagada.
data.multas[].tipostringcomparendo si la multa sigue vigente; resolucion si ya escaló a sanción con número de resolución.
data.multas[].valornumber (COP)Valor de la multa.
data.acuerdosPagonumberCantidad de acuerdos de pago sobre la deuda.
modestringlive = 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.
fetchedAtstring (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

Última revisión: 14 de septiembre de 2026 · Versión de la API: v1 · Fuentes y metodología

Contacto