Endpoint: multas y comparendos (SIMIT)

Con la placa y el documento devuelve cuánto se debe en multas de tránsito según el SIMIT y el detalle de cada comparendo: número, fecha, infracción, estado, valor y la placa a la que está asociado. Une las dos búsquedas sin repetir multas: las del VEHÍCULO, que viajan con la placa aunque no sean de su dueño actual, y las de la PERSONA del documento, incluidas las de sus otras placas, que también le bloquean trámites como el traspaso. Cada multa dice a quién está asociada: asociadaDocumento indica si la persona del documento es la infractora (en false, la multa sale solo por la placa y es de otro infractor) y asociadaPlaca si es del vehículo consultado (en false, es de esa persona en otro vehículo). Con esos dos campos se separa la deuda de la persona de la del carro. El detalle ampliado de un comparendo, los acuerdos de pago y las resoluciones tienen endpoints propios.

POST/api/multas1 crédito

Comparendos y deuda del SIMIT consolidados por placa + documento: une las multas del vehículo con las del documento enviado (también las de otras placas de esa persona, que le bloquean trámites como el traspaso), sin repetir ninguna. Devuelve el total adeudado en pesos, número de multas, el detalle de cada una (fecha, organismo, infracción, código, estado pendiente/acuerdo/pagada, valor, placa a la que está asociada y tipo: comparendo vigente o resolucion si ya escaló) y cuántos acuerdos de pago hay. Cada multa dice a quién está asociada: asociadaDocumento es true si la persona del documento es la infractora y false si la multa sale solo por la placa (otro conductor, un dueño anterior); asociadaPlaca es true si es de la placa consultada y false si es de esa persona en otro vehículo. Para quedarse con la deuda de la persona, filtrar por asociadaDocumento; con la del vehículo, por asociadaPlaca. El total consolida las dos clases a propósito e incluye lo pendiente de los acuerdos de pago; para la lista de solo comparendos vigentes está /api/comparendos. status: ok sin deuda, warn con deuda (multas o acuerdos pendientes) y danger si la deuda pasa de $1.000.000.

Cuerpo de la solicitud

body (JSON)
{
  "placa": "ABC123",
  "docType": "CC",
  "docNumber": "1020304050"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
placaobligatoriostringPlaca del vehículo. 5 a 7 caracteres alfanuméricos: cubre AAA000, AAA00A y los formatos menos comunes (AAA00, AAAA00). Los guiones y espacios se ignoran. Si la mandas dentro del alias interno de tu flota (`ABC12D_JPG`, `ABC12D-JUAN-PEREZ`, `ABC12D-MOVIL-11`) se extrae la placa, siempre que en el texto haya UNA sola: con dos o con ninguna la respuesta es 400.
docTypeobligatoriostringTipo de documento del propietario (CC, CE, NIT, PA, TI, CD, PPT, RC). Se aceptan alias comunes: PAS y PASAPORTE se normalizan a PA, y P.P.T. y P.P. —como lo abrevia la tarjeta de propiedad— se normalizan a PPT.Valores: CC · CE · NIT · PA · TI · CD · PPT · RC
docNumberobligatoriostringNúmero de documento del propietario. Alias aceptado: `doc`.
refreshbooleanIgnora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).

Ejemplos por lenguaje

cURL
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"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/multas", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"placa":"ABC123","docType":"CC","docNumber":"1020304050"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/multas",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"placa":"ABC123","docType":"CC","docNumber":"1020304050"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)
{
  "source": "multas",
  "status": "danger",
  "data": {
    "totalDeuda": 1045400,
    "totalMultas": 2,
    "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
      },
      {
        "comparendoId": "11001000000087654321",
        "fecha": "2025-06-02",
        "organismo": "SECRETARÍA DISTRITAL DE MOVILIDAD DE BOGOTÁ",
        "infraccion": "Estacionar un vehículo en sitios prohibidos",
        "codigo": "C02",
        "estado": "pendiente",
        "valor": 522700,
        "tipo": "resolucion",
        "placa": "ABC123",
        "asociadaDocumento": false,
        "asociadaPlaca": true
      }
    ],
    "acuerdosPago": 0
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z"
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

Casos de uso por sector y precio por volumen de la consulta de multas y comparendos: API SIMIT.

Última revisión: 14 de septiembre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto