Endpoint: deudores morosos de Bogotá (distrital)

Devuelve si una persona o empresa figura en el boletín de deudores morosos del Distrito Capital, consultado por CC o NIT. Incluye el número de obligaciones y el detalle público disponible. Es el boletín distrital de Bogotá, no el registro nacional de la Contaduría: un resultado negativo significa que no figura en este boletín, no que no deba al Estado. Una respuesta negativa también es un hallazgo y cobra; solo la caída de la fuente reembolsa.

POST/api/deudores-morosos1 crédito

¿Figura una persona o empresa como deudor moroso del Distrito Capital (Bogotá)? Consulta por CC o NIT contra el boletín distrital. Devuelve encontrado, cantidad de obligaciones y el detalle público cuando hay reporte. ⚠️ Es el boletín distrital, no el BDME nacional de la Contaduría: encontrado:false significa «no figura como deudor moroso del Distrito», no «no debe al Estado». Reportado = hallazgo (cobra); no reportado = ok y también cobra. Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)

{
  "tipoDocumento": "CC",
  "documento": "0000000000"
}

Parámetros del cuerpo de la solicitud
Campo	Tipo	Qué es
tipoDocumentoobligatorio	string	`CC` o `NIT`. Alias: `tipo`, `tipoDoc`.
documentoobligatorio	string	Cédula (6-10 dígitos) o NIT (9-10 dígitos, sin dígito de verificación). Alias: `numero`, `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

curl -X POST 'https://placapi.com/api/deudores-morosos' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"tipoDocumento":"CC","documento":"0000000000"}'

JavaScript (fetch)

const res = await fetch("https://placapi.com/api/deudores-morosos", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"tipoDocumento":"CC","documento":"0000000000"}),
});
const data = await res.json();

Python (requests)

import requests

res = requests.post(
    "https://placapi.com/api/deudores-morosos",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"tipoDocumento":"CC","documento":"0000000000"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)

{
  "source": "identidad",
  "status": "warn",
  "data": {
    "pais": "CO",
    "tipoDocumento": "CC",
    "documento": "0000000000",
    "encontrado": true,
    "cantidad": 2,
    "deudas": [
      {
        "impuesto": "PREDIAL",
        "objeto": "AAA0000TEST",
        "vigencia": "2018",
        "periodo": "0",
        "fecha": "01-01-2026"
      },
      {
        "impuesto": "PREDIAL",
        "objeto": "AAA0000DEMO",
        "vigencia": "2021",
        "periodo": "0",
        "fecha": "01-01-2026"
      }
    ],
    "cobertura": {
      "reporte": true,
      "detalle": true,
      "noPublicados": [
        "montos individuales no estructurados (texto de la fuente)",
        "datos de contacto"
      ]
    }
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z",
  "cost": 1
}

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