Endpoint: multas y comparendos (SIMIT)
Con la placa devuelve cuánto debe un vehículo en multas de tránsito según el SIMIT y el detalle de cada comparendo: número, fecha, infracción, estado y valor. El detalle ampliado de un comparendo, los acuerdos de pago y las resoluciones tienen endpoints propios. La diferencia con los endpoints por cédula es el sujeto: aquí la deuda es del VEHÍCULO. Un carro puede tener comparendos que no son de su dueño actual, porque la multa viaja con la placa, y por eso este es el que se consulta antes de comprar un usado y no el de la persona.
Comparendos y deuda del SIMIT consolidados por placa + documento: total adeudado en pesos, número de multas, el detalle de cada una (fecha, organismo, infracción, código, estado pendiente/acuerdo/pagada y valor) y cuántos acuerdos de pago hay. `status`: ok sin multas, warn con multas y danger si la deuda pasa de $1.000.000.
Cuerpo de la solicitud
{
"placa": "ABC123",
"docType": "CC",
"docNumber": "1020304050"
}| Campo | Tipo | Qué es |
|---|---|---|
| placaobligatorio | string | Placa 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. |
| docTypeobligatorio | string | Tipo 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 |
| docNumberobligatorio | string | Número de documento del propietario. Alias aceptado: `doc`. |
| refresh | boolean | Ignora 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 -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"}'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();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
{
"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
}
],
"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.
Última revisión: 20 de agosto de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.