Endpoint: detalle de un comparendo puntual

Busca un comparendo concreto por su número dentro de los que el SIMIT tiene para una cédula y devuelve el registro completo: fecha, organismo, infracción, código, estado, valor y departamento. Si ese número no figura entre los de la persona responde encontrado en falso con el comparendo en null; ese caso también cobra, porque la consulta al SIMIT se hizo y saber que no aparece es información. Existe porque /api/comparendos devuelve la lista completa y hay flujos que ya tienen el número guardado —de una consulta anterior, de un comparendo que el usuario escribió— y solo quieren refrescar ese. La respuesta es el mismo objeto que aparecería dentro de la lista, no una forma distinta, así que el código que ya pinta un comparendo sirve igual.

POST/api/comparendo1 crédito

Detalle de un comparendo puntual: se busca por su número dentro de los comparendos de la persona (cédula) y se devuelve el item completo (fecha, organismo, infracción, código, estado, valor, departamento) o `encontrado: false` con `comparendo: null` si no figura. Ese caso también cobra: la consulta al SIMIT se hizo y la respuesta —que no aparece— es información. `status`: info si no se encontró, ok si está pagada, warn si no.

Cuerpo de la solicitud

body (JSON)
{
  "docType": "CC",
  "docNumber": "1020304050",
  "numeroComparendo": "11001000000012345678"
}
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).
numeroComparendoobligatoriostringNúmero del comparendo a buscar dentro de los de la persona. Alias aceptado: `comparendo`.

Ejemplos por lenguaje

cURL
curl -X POST 'https://placapi.com/api/comparendo' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"docType":"CC","docNumber":"1020304050","numeroComparendo":"11001000000012345678"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/comparendo", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"docType":"CC","docNumber":"1020304050","numeroComparendo":"11001000000012345678"}),
});
const data = await res.json();
Python (requests)
import requests

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

Respuesta exitosa

200 OK — datos ficticios de ejemplo
{
  "source": "multas",
  "status": "warn",
  "data": {
    "documentNumber": "1020304050",
    "numeroComparendo": "11001000000012345678",
    "encontrado": true,
    "comparendo": {
      "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-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: 23 de agosto de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto