Endpoint: estado de cuenta de tránsito por cédula

Devuelve toda la deuda de tránsito que el SIMIT tiene registrada a nombre de una persona: sus comparendos, sus resoluciones sancionatorias —las multas que ya quedaron en firme— y sus acuerdos de pago, con el detalle de cada ítem, el subtotal de cada bloque y el total adeudado. Es la respuesta completa a la pregunta de si un conductor debe algo. Consultar solo los comparendos deja por fuera a quien debe una multa en firme o está pagando un acuerdo, y esa persona sale limpia sin estarlo. Cuesta 2 créditos por consulta con datos, uno menos que pedir /api/comparendos, /api/resoluciones y /api/acuerdos-pago por separado, y los ítems llegan con la misma forma que en esos tres.

POST/api/estado-cuenta-transito2 créditos

Toda la deuda de tránsito de una persona por cédula (fuente SIMIT) en una sola respuesta: sus comparendos, sus resoluciones sancionatorias —las multas en firme— y sus acuerdos de pago, cada bloque con su conteo, su subtotal y el detalle de cada ítem en la misma forma que entregan /api/comparendos, /api/resoluciones y /api/acuerdos-pago. Cuesta 2 créditos: pedir los tres por separado cuesta 3. totalDeuda es el total del estado de cuenta de la persona, la cifra con la que hay que comparar; no sumes los subtotales, porque una misma infracción puede figurar en dos bloques. pazSalvo es true solo si ese total es 0. Úsalo cuando la pregunta es si alguien debe algo: consultar solo los comparendos deja por fuera a quien debe una multa en firme o está pagando un acuerdo. status: ok sin deuda ni ítems, warn con deuda y danger si pasa de $1.000.000. Una persona sin deuda también es una consulta con datos y se cobra; la respuesta trae cost con lo cobrado (0 si salió de caché).

Cuerpo de la solicitud

body (JSON)
{
  "docType": "CC",
  "docNumber": "1020304050"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
docTypeobligatoriostringTipo de documento (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. se normalizan a PPT.Valores: CC · CE · NIT · PA · TI · CD · PPT · RC
docNumberobligatoriostringNúmero de documento. 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/estado-cuenta-transito' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"docType":"CC","docNumber":"1020304050"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/estado-cuenta-transito", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"docType":"CC","docNumber":"1020304050"}),
});
const data = await res.json();
Python (requests)
import requests

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

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)
{
  "source": "multas",
  "status": "danger",
  "data": {
    "documentNumber": "1020304050",
    "totalDeuda": 1860416,
    "pazSalvo": false,
    "totalComparendos": 1,
    "deudaComparendos": 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.",
        "tipo": "comparendo"
      }
    ],
    "totalResoluciones": 1,
    "deudaResoluciones": 837716,
    "resoluciones": [
      {
        "comparendoId": "0002204801",
        "fecha": "2025-09-15",
        "organismo": "Jamundí",
        "infraccion": "No detenerse ante una luz roja o amarilla de semáforo",
        "codigo": "D04",
        "estado": "pendiente",
        "valor": 837716,
        "departamento": "Valle del Cauca",
        "tipo": "resolucion"
      }
    ],
    "totalAcuerdos": 1,
    "pendienteAcuerdos": 500000,
    "acuerdos": [
      {
        "resolucion": "324",
        "fechaResolucion": "2018-02-16",
        "estado": "Acuerdo de pago",
        "valorAcuerdo": 837716,
        "pendiente": 500000,
        "secretaria": "Bello",
        "departamento": "Antioquia"
      }
    ]
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z",
  "cost": 2
}

Errores y cobro

Cuesta 2 créditos 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: 2 de octubre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto