API para consultar comparendos por cédula en Colombia

Qué problema resuelve

El SIMIT publica los comparendos de una persona en un portal con captcha y proof-of-work, pensado para que alguien los mire una vez, no para que un sistema los revise a diario. Quien necesita saber si un conductor tiene comparendos pendientes —antes de contratarlo, de entregarle un vehículo o de aprobarle un trámite— termina copiando cédulas a mano. Este endpoint entrega ese mismo registro como REST, tipado y con el total ya sumado.

Para quién sirve

Empresas de transporte y flotas que verifican a sus conductores, plataformas de movilidad y domicilios que validan repartidores, aseguradoras que evalúan riesgo por comportamiento vial, áreas de talento humano que contratan personal con cargo de conducción, y cualquier producto que ya consulte la licencia y necesite el historial de infracciones de la misma persona.

Datos requeridos

• docType — tipo de documento del conductor (CC, CE, TI, PA, NIT o los demás del registro).
• docNumber — número de documento, sin puntos ni espacios.
• refresh — opcional: true salta el caché de 24 horas y vuelve a preguntarle al SIMIT.

Fuentes y cobertura

• SIMIT — Sistema Integrado de Información sobre Multas y Sanciones por Infracciones de TránsitoRegistro nacional que administra la Federación Colombiana de Municipios. Es la misma fuente de la consulta por placa, entrando por el documento del infractor en vez de por el vehículo.

¿Cómo consultar los comparendos de una persona por su cédula?

Con una llamada POST a /api/comparendos enviando docType y docNumber. La respuesta trae la lista de comparendos con fecha, organismo, infracción, código, estado, valor y departamento, más el total adeudado.

¿En qué se diferencia de la consulta de multas por placa?

La consulta por placa (/api/multas) trae lo que el SIMIT asocia al VEHÍCULO; esta trae lo que asocia a la PERSONA. Un conductor multado en un vehículo ajeno solo aparece en esta, y un comparendo impuesto al vehículo solo aparece en aquella.

Ejemplo de solicitud

POST https://placapi.com/api/comparendos. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.

curl -X POST 'https://placapi.com/api/comparendos' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"docType":"CC","docNumber":"1020304050"}'

Parámetros, errores y ejemplos en cURL, JavaScript y Python: documentación de POST /api/comparendos.

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": {
    "documentNumber": "1020304050",
    "totalComparendos": 1,
    "totalDeuda": 522700,
    "comparendos": [
      {
        "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,
        "departamento": "BOGOTÁ D.C."
      }
    ]
  },
  "mode": "live",
  "fetchedAt": "2026-09-16T14:03:11.000Z"
}

Explicación campo por campo

Limitaciones y posibles errores

• Devuelve lo que el SIMIT tiene asociado al DOCUMENTO. Un comparendo impuesto al vehículo y no al conductor aparece en la consulta por placa (/api/multas), no acá: para cubrir los dos casos hay que pedir ambos.
• Una persona sin comparendos responde con la lista vacía y SÍ cobra. El producto es el veredicto, no el listado: certificar que un conductor está limpio tiene el mismo valor que enumerar sus multas.
• No liquida ni paga: los valores son los que reporta el registro, sin descuentos por pronto pago ni intereses del día. El pago se hace en el organismo de tránsito.
• No incluye las sanciones que aún no llegaron al SIMIT. Un comparendo recién impuesto puede tardar días en aparecer, y ese retraso es de la fuente.

Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.

Otras preguntas frecuentes

Seguir explorando

• API SIMIT: multas por placa→
• API de licencias de conducción→
• API de nombre por cédula→
• API de consulta vehicular por placa→
• API de antecedentes judiciales→
• Documentación e integración→
• Documentación del endpoint POST /api/comparendos→