API de antecedentes disciplinarios de la Procuraduría por documento

Qué problema resuelve

Antes de vincular a alguien o de firmar un contrato hay que revisar si tiene inhabilidades vigentes, y el certificado oficial llega como PDF con tablas. Quien necesita esa verificación dentro de un flujo automatizado termina descargando y leyendo documentos uno por uno. Este endpoint entrega el mismo certificado ya convertido en campos, e incluye `inhabilitadoHasta`, que responde de un vistazo la pregunta real: si esa persona puede ser vinculada hoy.

Para quién sirve

Áreas de talento humano y cumplimiento, entidades que contratan con el Estado y deben verificar inhabilidades, empresas de estudios de seguridad, y plataformas de contratación de personal.

Datos requeridos

• docType — tipo de documento (CC, CE, NIT, PPT o PEP).
• docNumber — número de documento.
• primerNombre — opcional: solo ahorra un par de peticiones al resolver la pregunta de seguridad del portal; no cambia el resultado.

Fuentes y cobertura

• Procuraduría General de la Nación — SIRICertificado de antecedentes disciplinarios: sanciones con su término y clase, delitos, providencias con autoridad y fechas, inhabilidades con su vigencia, y el número del certificado.

¿Cómo consultar los antecedentes disciplinarios por API?

Con una llamada POST a /api/antecedentes-disciplinarios enviando docType y docNumber. La respuesta llega en JSON con `tieneAntecedentes`, el nombre del titular, el número del certificado y, si hay anotaciones, cada una con su sanción, su término y la vigencia de la inhabilidad.

¿Qué diferencia hay con los antecedentes judiciales?

Son registros distintos y de entidades distintas. Los disciplinarios los lleva la Procuraduría y cubren sanciones e inhabilidades del ejercicio público o profesional; los judiciales los lleva la Policía Nacional y responden si la persona tiene asuntos pendientes con las autoridades judiciales. Hacen falta los dos para una verificación completa.

Ejemplo de solicitud

POST https://placapi.com/api/antecedentes-disciplinarios. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.

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"}'

Ejemplo de respuesta

Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).

{
  "source": "antecedentes-disciplinarios",
  "status": "ok",
  "data": {
    "documento": "1020304050",
    "tipoDocumento": "Cédula de ciudadanía",
    "nombre": "JUAN PEREZ GOMEZ",
    "tieneAntecedentes": false,
    "descripcion": "No registra sanciones ni inhabilidades vigentes",
    "anotaciones": [],
    "totalAnotaciones": 0,
    "inhabilitadoHasta": "",
    "certificadoNumero": "1234567"
  }
}

Explicación campo por campo

Limitaciones y posibles errores

• Una respuesta "no registra antecedentes" COBRA. Es el dato que se vino a comprar —es el que sirve para contratar a alguien—, no una consulta sin resultado.
• Esta fuente maneja CC, CE, NIT, PPT y PEP. Con PA, TI, CD o RC responde 400 sin cobrar: las personas naturales y jurídicas se certifican por vías distintas.
• El certificado incluye antecedentes disciplinarios, penales, contractuales, fiscales y de pérdida de investidura, según lo que la Procuraduría consolide.
• La lista de anotaciones viene topada en 50; el conteo real está en `totalAnotaciones`.

Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.

Otras preguntas frecuentes

Seguir explorando

• API de antecedentes judiciales→
• API de antecedentes fiscales→
• API de listas restrictivas y OFAC→
• API de nombre por cédula→
• Documentación e integración→