API de antecedentes judiciales de Colombia: verificación por cédula vía REST

Qué problema resuelve

El portal de la Policía Nacional obliga a aceptar términos, resolver un reCAPTCHA de imágenes y copiar el resultado a mano. Para un área de selección que vincula veinte personas al mes, o para una plataforma que verifica conductores, domiciliarios o arrendatarios, eso significa un trámite manual por cada candidato y un pantallazo pegado en una carpeta que nadie puede auditar después. Tampoco hay forma de disparar la verificación desde un formulario de onboarding. PlacApi convierte esa consulta en un endpoint REST que responde un JSON estable, con la leyenda oficial íntegra para que quede como soporte.

Para quién sirve

Áreas de selección y talento humano, empresas de vigilancia y seguridad privada, plataformas de domicilios y movilidad que vinculan conductores, inmobiliarias y aseguradoras que estudian arrendatarios, fintechs con obligaciones de conocimiento del cliente, y cualquier equipo que hoy pide el certificado en PDF y lo revisa a ojo.

Datos requeridos

• docType — tipo de documento. Esta fuente maneja CC (cédula de ciudadanía), CE (cédula de extranjería), PA (pasaporte) y CD (documento de país de origen).
• docNumber — número de documento, entre 5 y 15 dígitos. También se acepta como `doc`.

Fuentes y cobertura

• Registro de antecedentes judiciales de la Policía NacionalConsulta en línea de antecedentes penales y requerimientos judiciales. Se consulta en vivo en cada solicitud; la respuesta se guarda 24 horas para no repetir la misma pregunta el mismo día.

¿Esta API muestra si alguien tiene condenas anteriores?

No. Certifica si la persona tiene asuntos pendientes con las autoridades judiciales en el momento de la consulta. Por la Sentencia SU-458 de 2012, la consulta que hace un tercero no revela condenas cumplidas o prescritas. Es exactamente la misma información que entrega el portal oficial a cualquiera que consulte una cédula ajena.

¿Cuánto cuesta cada consulta?

2 créditos. Es uno de los cuatro endpoints de PlacApi que cuestan 2 —junto con consulta full, pérdida total y el RUAF—, porque la fuente exige resolver un captcha en cada consulta viva y eso se paga por llamada. Un hit de caché no cobra y, si la fuente falla, los 2 créditos se devuelven.

Ejemplo de solicitud

POST https://placapi.com/api/antecedentes-judiciales. 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-judiciales' \
  -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-judiciales",
  "status": "ok",
  "data": {
    "documento": "1020304050",
    "nombre": "PEREZ GOMEZ JUAN CARLOS",
    "tipoDocumento": "Cédula de Ciudadanía",
    "tieneAntecedentes": false,
    "descripcion": "No tiene asuntos pendientes con las autoridades judiciales",
    "anotaciones": [],
    "fechaConsulta": "11/08/2026 05:50:05 PM"
  },
  "mode": "live",
  "fetchedAt": "2026-08-11T22:53:35.570Z",
  "cost": 2
}

Explicación campo por campo

Limitaciones y posibles errores

• NO es un historial penal. Por la Sentencia SU-458 de 2012 de la Corte Constitucional, la consulta que hace un tercero no revela condenas ya cumplidas o prescritas: certifica si la persona tiene asuntos pendientes HOY. Verificado sobre 400 consultas, incluidas decenas de personas con condena conocida, ninguna devolvió antecedentes.
• El registro usa dos leyendas distintas para el caso sin asuntos pendientes y no significan lo mismo. Por eso la respuesta trae la frase textual: la decisión de qué hacer con cada una es de quien contrata, no nuestra.
• Maneja CC, CE, PA y CD. Con NIT, tarjeta de identidad, PPT, registro civil o PEP responde 400 `tipo_documento_no_soportado`: ese registro no los tiene.
• Entre el 3 % y el 6 % de las consultas fallan porque la fuente devuelve una respuesta vacía. Se reintenta una vez de forma automática y, si vuelve a fallar, la respuesta es 502 y NO se cobra.
• Consultar antecedentes de una persona implica tratar sus datos personales. La finalidad y la autorización son responsabilidad de quien consulta, no de PlacApi.

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

Otras preguntas frecuentes

Seguir explorando

• Ver los cinco endpoints de antecedentes y probarlos→
• API de licencias de conducción por cédula→
• API del SIMIT: multas por cédula o placa→
• API de consulta vehicular (ficha del RUNT)→
• API de nombre por cédula→
• API de procesos judiciales→
• API del RUAF: EPS, pensión y ARL→
• API de antecedentes disciplinarios→
• API de antecedentes fiscales→
• API de listas restrictivas y OFAC→
• API de verificación de identidad: las once consultas→