Endpoint: acuerdos de pago de comparendos

Devuelve los acuerdos de pago de comparendos que una persona tiene registrados en el SIMIT: de cada uno, la resolución, la fecha, el estado, el valor del acuerdo, el saldo pendiente, la secretaría y el departamento, más el total pendiente. Es lo que responde si alguien ya está pagando a plazos una multa, dato que no aparece mirando solo el listado de comparendos. Es el dato que no se ve mirando el listado de comparendos: una multa dentro de un acuerdo sigue apareciendo como deuda, pero está siendo pagada a plazos y su tratamiento es otro. Quien decide si alguien está al día necesita cruzar /api/comparendos con este, o le va a contar como moroso a quien tiene un acuerdo vigente.

POST/api/acuerdos-pago1 crédito

Acuerdos de pago de comparendos de una persona por cédula (fuente SIMIT): resolución, fecha, estado, valor del acuerdo, saldo pendiente, secretaría y departamento de cada uno, más el total pendiente. `status`: ok sin acuerdos, warn con al menos uno.

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/acuerdos-pago' \
  -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/acuerdos-pago", {
  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/acuerdos-pago",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"docType":"CC","docNumber":"1020304050"},
)
data = res.json()

Respuesta exitosa

200 OK — datos ficticios de ejemplo
{
  "source": "multas",
  "status": "warn",
  "data": {
    "documentNumber": "1020304050",
    "totalAcuerdos": 1,
    "totalPendiente": 500000,
    "acuerdos": [
      {
        "resolucion": "324",
        "fechaResolucion": "2018-02-16",
        "estado": "Acuerdo de pago",
        "valorAcuerdo": 837716,
        "pendiente": 500000,
        "secretaria": "Jamundí",
        "departamento": "Valle del Cauca"
      }
    ]
  },
  "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