Endpoint: antecedentes judiciales (Policía Nacional)

Con el documento de una persona devuelve si tiene asuntos pendientes con las autoridades judiciales según el sistema de la Policía Nacional. No es un historial penal: por la Sentencia SU-458 de 2012 la consulta que hace un tercero no revela condenas ya cumplidas o prescritas. El campo descripcion trae la leyenda textual del registro, que tiene dos formas distintas para el caso sin asuntos pendientes; conviene leerla y no solo la bandera booleana.

POST/api/antecedentes-judiciales2 créditos

Antecedentes judiciales de una persona por documento, del sistema de la Policía Nacional. Certifica si la persona **tiene asuntos pendientes con las autoridades judiciales HOY**; por la Sentencia SU-458 de 2012 la consulta de terceros no revela condenas ya cumplidas o prescritas, así que no es un historial penal. `descripcion` trae la leyenda textual del registro, que tiene dos formas para el caso sin asuntos pendientes y no son intercambiables: conviene leerla, no solo la bandera. Devuelve además el nombre del titular en orden apellidos-nombres. **`nombre` vacío es una señal, no un hueco**: el registro omite esa línea cuando el documento no figura en la Registraduría. **Cuesta 2 créditos**: es el único endpoint de la familia que paga un resolvedor de captcha en cada consulta viva. Un hit de caché no cobra, y si la fuente falla se devuelven los 2.

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, PA y CD (documento de país de origen). Con NIT, TI, PPT, RC o PEP responde 400 `tipo_documento_no_soportado`.Valores: CC · CE · PA · CD
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/antecedentes-judiciales' \
  -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-judiciales", {
  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-judiciales",
    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-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-07-24T15:04:05.000Z",
  "cost": 2
}

Errores y cobro

Cuesta 2 créditos 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