Consultar validación de antecedentes

GET /validate/background HTTP/1.1
Host: {{api_auco}}
Authorization: {{public_key}}

Servicio para realizar la consulta de una validación de antecedentes.

Autenticación

Incluye tu llave publica en el encabezado Authorization.

Authorization: puk_xxx...

Parámetros de consulta

Nombre	Descripción
code String	Obligatorio. Codigo del proceso a consultar.

🧪 Ejemplo de uso

Curl
Python
Node.js

curl -X GET '{{api_auco}}/validate/background?code=XXXXXXXXX' \
  -H 'Authorization: {{public_key}}'

import requests

response = requests.get(
  "{{api_auco}}/validate/background",
  headers={"Authorization": "{{public_key}}"},
  params={"code": "XXXXXXXXX"}
)
print(response.json())

const axios = require('axios');

axios
  .get('{{api_auco}}/validate/background', {
    headers: { Authorization: '{{public_key}}' },
    params: { code: 'XXXXXXXXX' },
  })
  .then((response) => console.log(response.data));

📥 Ejemplos de respuesta

info

La propiedad ready indica si el proceso de validación ha sido completado o si el documento aún no está listo. En caso de estar listo, se incluirá la propiedad url con la URL firmada para la descarga del documento. Las URLs firmadas tienen una validez de 2 minutos antes de expirar.

Validación pendiente.
Validación lista.

{
  "code": "XXXXXXXXX",
  "name": "1001001010",
  "email": "example@auco.ai",
  "data": {
    "name": "NOMBRE APELLIDO APELLIDO",
    "type": "CC",
    "identification": "1001001010",
    "expeditionDate": "01/01/1995"
  },
  "ready": false
}

{
  "code": "XXXXXXXXX",
  "name": "1001001010",
  "url": "https://s3.amazonaws.com/.../signed-url",
  "email": "example@auco.ai",
  "data": {
    "type": "CC",
    "identification": "1001001010",
    "expeditionDate": "01/01/1995",
    "name": "NOMBRE APELLIDO APELLIDO",
    "error": true,
    "reports": false
  },
  "ready": true,
  "validation": {
    "contaduria": false,
    "contraloria": false,
    "defuncion": {
      "date": "25/02/2026",
      "doc": 1001001010,
      "validity": "Vigente (Vivo)"
    },
    "delitos_sexuales": [],
    "hallazgos": {
      "altos": [],
      "bajos": [
        {
          "cantidad": "001",
          "codigo": "sigep",
          "coincidencia": "True",
          "descripcion": "El documento consultado tiene registrada su hoja de vida con información laboral y antecedentes en el Sistema de Información y Gestión del Empleo Público (SIGEP) de Colombia.",
          "fuente": "sigep",
          "hallazgo": "SIGEP: El documento consultado registra en el Sistema de Información y Gestión del Empleo Público",
          "html_id": null
        },
        {
          "cantidad": "001",
          "codigo": "reputacional_news",
          "coincidencia": "True",
          "descripcion": "Es posible que el titular de documento se encuentra en al menos una noticia o sitio de internet al consultarlo con base a su nombre completo.",
          "fuente": "reputacional",
          "hallazgo": "Noticias Reputacionales: El nombre consultado registra en al menos una noticia o sitio web.",
          "html_id": null
        },
        {
          "cantidad": "001",
          "codigo": "reputacional_social",
          "coincidencia": "True",
          "descripcion": "Es posible que el titular de documento se encuentra en alguna red social como Facebook, LinkedIn, YouTube o Twitter.",
          "fuente": "reputacional",
          "hallazgo": "Redes Sociales: El nombre consultado presenta coincidencia en alguna red social",
          "html_id": null
        }
      ],
      "infos": [
        {
          "cantidad": "001",
          "codigo": "rut",
          "coincidencia": "True",
          "descripcion": "El titular del documento está inscrito en el Registro Único Tributario (RUT).",
          "fuente": "rut",
          "hallazgo": "RUT: El documento consultado se encuentra en el Registro Único Tributario.",
          "html_id": null
        },
        {
          "cantidad": "001",
          "codigo": "rama_proceso_csv",
          "coincidencia": "True",
          "descripcion": "El nombre al ser consultado en la fuente, registra en más de un proceso judicial.",
          "fuente": "rama_unificada",
          "hallazgo": "Rama Unificada: El nombre consultado registra en 15 procesos con coincidencia parcial.",
          "html_id": "https://app.auco.ai/validation/download/rama_unificada/example-uuid.zip"
        }
      ],
      "medios": []
    },
    "nivel": "bajo",
    "interpol": false,
    "ofac": false,
    "policia": false,
    "proveedores_ficticios": false,
    "rama": {
      "bogotajepms": false,
      "medellinjepms": false,
      "calijepms": false,
      "barranquillajepms": false
    },
    "rama_unificada": [
      {
        "actuaciones": [],
        "cantFilas": 0,
        "claseProceso": "",
        "demandado": null,
        "demandante": null,
        "departamento": "",
        "despacho": "",
        "detalle": false,
        "dict_data_extra": [
          {
            "number_of_pages": 1,
            "number_of_private_records": 0,
            "number_of_records": 15,
            "pages_consulted": 1,
            "processes_active": 0,
            "registra_como_hallazgo": true,
            "url_csv": "https://app.auco.ai/validation/download/rama_unificada/example-uuid.zip"
          }
        ],
        "esPrivado": null,
        "fechaConsulta": "2026-02-25T14:52:03",
        "fechaProceso": "",
        "idProceso": 0,
        "llaveProceso": "",
        "tipoProceso": "",
        "ubicacion": ""
      }
    ],
    "registraduria": {
      "cedula": "1001001010",
      "estado": "VIGENTE",
      "fecha_exp": "1 DE ENERO DE 1995",
      "lugar_exp": "BOGOTA - CUNDINAMARCA",
      "nombre": "NOMBRE APELLIDO APELLIDO"
    },
    "rues": {
      "actividades_economicas": [
        "4721 Comercio al por menor de productos agrícolas para el consumo en establecimientos especializados"
      ],
      "categoria_matricula": "PERSONA NATURAL",
      "clase_identificacion": "CEDULA DE CIUDADANIA",
      "estado": "ACTIVA",
      "identificacion": "NIT 1001001010",
      "matricula": "0000000000",
      "municipio": "BOGOTA / CUNDINAMARCA",
      "nit": 1001001010,
      "organizacion_juridica": "PERSONA NATURAL",
      "razon_social": "APELLIDO NOMBRE",
      "registro_mercantil": {
        "categoria_de_la_matricula": "PERSONA NATURAL",
        "estado_de_la_matricula": "ACTIVA",
        "fecha_de_matricula": "2026-01-01",
        "fecha_de_renovacion": "2026-01-01",
        "numero_de_matricula": "000000",
        "tipo_de_organización": "PERSONA NATURAL",
        "tipo_de_sociedad": "SOCIEDAD COMERCIAL",
        "último_año_renovado": "2026"
      },
      "tipo": "SOCIEDAD COMERCIAL"
    },
    "rut": "1001001010-0",
    "rut_estado": "REGISTRO ACTIVO"
  }
}

Campos de la respuesta

Campo	Tipo	Descripción
`code`	String	Código único del proceso de validación.
`name`	String	Número de identificación consultado.
`email`	String	Correo electrónico asociado al proceso.
`url`	String	URL firmada para descargar el reporte PDF. Solo presente cuando `ready: true`. Expira en 2 minutos.
`ready`	Boolean	Indica si la validación ha sido completada.
`data`	Object	Datos básicos de la persona consultada.
`data.name`	String	Nombre completo de la persona.
`data.type`	String	Tipo de documento (ej: `CC`, `CE`, `PA`).
`data.identification`	String	Número de identificación.
`data.expeditionDate`	String	Fecha de expedición del documento.
`data.error`	Boolean	Indica si hubo un error en alguna fuente de consulta.
`data.reports`	Boolean	Indica si se encontraron reportes negativos.
`validation`	Object	Resultados detallados de la validación de antecedentes. Solo presente cuando `ready: true`.

Campos del objeto `validation`

Campo	Tipo	Descripción
`contaduria`	Boolean	Resultado de consulta en la Contaduría General de la Nación.
`contraloria`	Boolean	Resultado de consulta en la Contraloría General de la República.
`defuncion`	Object	Información del estado de defunción. Incluye `date`, `doc` y `validity`.
`delitos_sexuales`	Array	Registros encontrados en la base de delitos sexuales.
`hallazgos`	Object	Hallazgos clasificados por nivel de riesgo.
`hallazgos.altos`	Array	Hallazgos de riesgo alto.
`hallazgos.medios`	Array	Hallazgos de riesgo medio.
`hallazgos.bajos`	Array	Hallazgos de riesgo bajo.
`hallazgos.infos`	Array	Hallazgos informativos.
`nivel`	String	Nivel de riesgo general: `bajo`, `medio` o `alto`.
`interpol`	Boolean	Resultado de consulta en listas de Interpol.
`ofac`	Boolean	Resultado de consulta en listas OFAC.
`policia`	Boolean	Resultado de consulta de antecedentes de policía.
`proveedores_ficticios`	Boolean	Resultado de consulta en lista de proveedores ficticios de la DIAN.
`rama`	Object	Resultados de consulta en despachos judiciales (JEPMS) por ciudad. Cada clave es un booleano.
`rama_unificada`	Array	Resultados de procesos judiciales de la Rama Judicial unificada.
`registraduria`	Object	Información de la Registraduría Nacional. Incluye `cedula`, `estado`, `fecha_exp`, `lugar_exp` y `nombre`.
`rues`	Object	Información del Registro Único Empresarial y Social (RUES).
`rut`	String	Número del Registro Único Tributario.
`rut_estado`	String	Estado del RUT (ej: `REGISTRO ACTIVO`).

Estructura de un hallazgo

Cada elemento en hallazgos.altos, hallazgos.medios, hallazgos.bajos y hallazgos.infos tiene la siguiente estructura:

Campo	Tipo	Descripción
`cantidad`	String	Cantidad de coincidencias encontradas.
`codigo`	String	Código identificador del tipo de hallazgo.
`coincidencia`	String	Indica si hubo coincidencia (`"True"` / `"False"`).
`descripcion`	String	Descripción detallada del hallazgo.
`fuente`	String	Fuente de la información.
`hallazgo`	String	Resumen del hallazgo encontrado.
`html_id`	String \| null	URL de descarga del detalle del hallazgo, si aplica.

⚠️ Respuestas de error

Código	Descripción
400	Falta parámetro `code`. Proceso no encontrado `VALIDATION_NOT_FOUND`.
401	Autenticación inválida o ausente.

Autenticación​

Parámetros de consulta​

🧪 Ejemplo de uso​

📥 Ejemplos de respuesta​

Campos de la respuesta​

Campos del objeto validation​

Estructura de un hallazgo​

⚠️ Respuestas de error​