Endpoint: antecedentes disciplinarios (Procuraduría)

Con el documento de una persona devuelve si registra sanciones o inhabilidades vigentes en el sistema SIRI de la Procuraduría General de la Nación, junto con el nombre del titular y el número de certificado para verificarlo ante la entidad. Cuando hay anotaciones no vienen como bloque de texto sino estructuradas —sanción, término, clase, delitos, providencia e inhabilidades con su vigencia— y inhabilitadoHasta resume la fecha más lejana, que es lo que responde si se puede vincular a esa persona hoy.

POST/api/antecedentes-disciplinarios1 crédito

Antecedentes disciplinarios de una persona por documento, del sistema SIRI de la Procuraduría General de la Nación. Devuelve si registra sanciones o inhabilidades vigentes, el nombre completo del titular y el número del certificado para verificarlo ante la entidad. Cuando hay anotaciones vienen ESTRUCTURADAS —sanción, término, clase, delitos, providencia (autoridad y fechas) e inhabilidades con su vigencia—, no como bloque de texto. `inhabilitadoHasta` resume la fecha más lejana de todas: es lo que responde "¿puedo vincular a esta persona hoy?" sin recorrer el resto (un certificado real trajo 323 anotaciones, y `anotaciones` viene topada en 50 con el conteo real en `totalAnotaciones`). Sin antecedentes responde `tieneAntecedentes: false` — y esa respuesta también cobra: es el dato que se necesita para contratar o vincular a alguien. Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)
{
  "docType": "CC",
  "docNumber": "1020304050"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
docTypeobligatoriostringTipo de documento. Esta fuente maneja CC, CE, NIT, PPT y PEP; con PA, TI, CD o RC responde 400 `tipo_documento_no_soportado`.Valores: CC · CE · NIT · PPT · PEP
docNumberobligatoriostringNúmero de documento. Alias aceptado: `doc`.
primerNombrestringPrimer nombre del titular. OPCIONAL y no lo exige la fuente: solo ahorra un par de peticiones al resolver la pregunta de seguridad del portal. No cambia el resultado ni la caché.
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/antecedentes-disciplinarios' \
  -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/antecedentes-disciplinarios", {
  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/antecedentes-disciplinarios",
    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": "antecedentes-disciplinarios",
  "status": "danger",
  "data": {
    "documento": "1020304050",
    "tipoDocumento": "Cédula de ciudadanía",
    "nombre": "JUAN PEREZ GOMEZ",
    "tieneAntecedentes": true,
    "descripcion": "Registra sanciones o inhabilidades vigentes",
    "anotaciones": [
      {
        "tipo": "SANCIONES PENALES",
        "registroSiri": "201221493",
        "sanciones": [
          {
            "sancion": "PRISION",
            "termino": "8 AÑOS",
            "clase": "PRINCIPAL",
            "suspendida": ""
          }
        ],
        "delitos": [
          "LAVADO DE ACTIVOS (LEY 599 DE 2000)"
        ],
        "providencias": [
          {
            "instancia": "PRIMERA",
            "autoridad": "JUZGADO 1 PENAL DEL CIRCUITO - BUGA (VALLE DEL CAUCA)",
            "fechaProvidencia": "06/09/2017",
            "fechaEfectosJuridicos": "11/06/2019"
          }
        ],
        "inhabilidades": [
          {
            "modulo": "PENAL",
            "inhabilidad": "INHABILIDAD PARA DESEMPEÑAR CARGOS PÚBLICOS LEY 1952 DE 2019 ART 42",
            "fechaInicio": "11/06/2019",
            "fechaFin": "10/06/2027"
          }
        ]
      }
    ],
    "totalAnotaciones": 1,
    "inhabilitadoHasta": "10/06/2027",
    "certificadoNumero": "301011498",
    "fechaExpedicion": "11 de agosto del 2026"
  },
  "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: 23 de agosto de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto