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. Código 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"
        },
        {
          "cantidad": "001",
          "codigo": "fosyga_regimen",
          "coincidencia": "True",
          "descripcion": "El documento consultado presenta novedad en el régimen de afiliación, aparece como Contributivo, Subsidiado o Especial en la BDUA (Base Datos Única de Afiliados del Sistema General de Seguridad Social).",
          "fuente": "fosyga",
          "hallazgo": "FOSYGA: Su régimen de afiliación a la EPS es: CONTRIBUTIVO",
          "html_id": null
        }
      ],
      "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",
    "nombre": "NOMBRE APELLIDO APELLIDO",
    "genero": "M",
    "tipo_documento": "CC",
    "fecha": "Este reporte fue generado el 25, Feb 2026 a las 10:04AM",
    "error": false,
    "errores": [],
    "fosyga": {
      "apellidos": "APELLIDO APELLIDO",
      "departamento": "BOGOTA D.C.",
      "documento": "1001001010",
      "entidad": "EPS SURAMERICANA S.A.",
      "estado": "ACTIVO",
      "fecha_afiliacion": "01/01/2020",
      "fecha_finalizacion_afiliacion": "31/12/2999",
      "municipio": "BOGOTA D.C.",
      "nombre_completo": "NOMBRE APELLIDO APELLIDO",
      "nombres": "NOMBRE",
      "regimen": "CONTRIBUTIVO",
      "tipo_afiliado": "COTIZANTE",
      "tipo_identificacion": "CC"
    },
    "lista_onu": false,
    "lista_banco_mundial": {
      "debarred_firms_individuals": [],
      "others_sanctions": []
    },
    "offshoreleaks": {
      "Bahamas Leaks": [],
      "Offshore Leaks": [],
      "Panama Papers": [],
      "Pandora Papers": [],
      "Paradise Papers": []
    },
    "europol": [],
    "iadb": [],
    "cidob": {},
    "ofac_nombre": false,
    "ofac_resultados": false,
    "peps": [],
    "peps_denom": [],
    "procuraduria": [],
    "sigep": {},
    "sirna": [],
    "paco_online": [],
    "inpec": {},
    "insolvencias": [],
    "juzgados_tyba": [],
    "reputacional": {
      "news": [
        {
          "description": "Noticia relacionada con el titular del documento.",
          "idioma": "es",
          "keyword": "NOMBRE APELLIDO APELLIDO",
          "link": "https://example.com/noticia",
          "news_source": "google_classic",
          "sentimiento": "neutral",
          "title": "Título de la noticia"
        }
      ],
      "notable": {},
      "social": []
    },
    "relacionados": []
  }
}

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 (RUT, FOSYGA, RUAF, SISBEN, SENA, etc.). No representan riesgo.
`nivel`	String	Nivel de riesgo general: `alto`, `medio`, `bajo` o `info` (sin hallazgos de riesgo).
`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 \| Boolean	Información del Registro Único Empresarial y Social (RUES). `false` si no hay registro.
`rut`	String	Número del Registro Único Tributario.
`rut_estado`	String	Estado del RUT (ej: `REGISTRO ACTIVO`).
`nombre`	String	Nombre completo del titular según la fuente consultada.
`genero`	String	Género reportado (`M` / `F`).
`tipo_documento`	String	Tipo de documento (ej: `CC`, `CE`, `PA`).
`fecha`	String	Fecha y hora en que fue generado el reporte.
`error`	Boolean	Indica si alguna fuente consultada presentó error. El detalle está en `errores`.
`errores`	Array<String>	Lista de fuentes que fallaron durante la consulta (ej: `["monteriajepms", "cartagenajepms"]`).
`fosyga`	Object	Información de afiliación a EPS en la BDUA (FOSYGA). Incluye `entidad`, `estado`, `regimen`, `tipo_afiliado`, `fecha_afiliacion`, `fecha_finalizacion_afiliacion`, `departamento`, `municipio`, entre otros.
`lista_onu`	Boolean	Coincidencia en la lista consolidada de sanciones de Naciones Unidas.
`lista_banco_mundial`	Object	Resultados del Banco Mundial. Incluye `debarred_firms_individuals` y `others_sanctions`.
`offshoreleaks`	Object	Coincidencias en filtraciones Offshore. Contiene `Panama Papers`, `Pandora Papers`, `Paradise Papers`, `Bahamas Leaks` y `Offshore Leaks`.
`europol`	Array	Coincidencias en listas de Europol.
`iadb`	Array	Coincidencias en la lista del Banco Interamericano de Desarrollo.
`cidob`	Object	Coincidencias en la base CIDOB (biografías de líderes políticos).
`ofac_nombre`	Boolean	Coincidencia de OFAC por nombre.
`ofac_resultados`	Boolean \| Array	Resultados adicionales de OFAC.
`peps`	Array	Coincidencias en listas PEP (Personas Expuestas Políticamente).
`peps_denom`	Array	Coincidencias PEP por denominación.
`procuraduria`	Array	Antecedentes en la Procuraduría General de la Nación.
`sigep`	Object	Información del Sistema de Información y Gestión del Empleo Público.
`sirna`	Array	Coincidencias en el Sistema de Información del Registro Nacional de Abogados.
`paco_online`	Array	Resultados del Portal Anticorrupción de Colombia (PACO).
`inpec`	Object	Información del Instituto Nacional Penitenciario y Carcelario.
`insolvencias`	Array	Procesos de insolvencia registrados.
`juzgados_tyba`	Array	Procesos judiciales en el sistema Tyba.
`reputacional`	Object	Información reputacional. Contiene `news` (noticias con `title`, `link`, `sentimiento`), `social` (redes sociales) y `notable`.
`relacionados`	Array	Personas relacionadas con el titular del documento.
`ruaf`	Object	Registro Único de Afiliados. Incluye afiliaciones a `Salud`, `Pensiones`, `ARL`, `Cesantías`, `Caja de compensación`, `Pensionado`, `Programas de Asistencia Social` y `Basico` (datos básicos).
`sisben`	Object	Clasificación SISBEN. Incluye `Grupo`, `Tipo de grupo`, `Departamento`, `Municipio`, `Estado` y `Actualizacion Ciudadano`.
`sena`	Array	Cursos y certificados del SENA. Cada elemento incluye `Programa`, `Tipo`, `Certificación`, `Registro` y `Descarga`.
`simit`	Object	Información del SIMIT (multas de tránsito). Incluye `paz_salvo`, `cantidad_multas`, `multas`, `acuerdos_pagos`, `total_pagar` y `cursos`.
`runt`	Object	Información del RUNT. Incluye `licencia` (licencias de conducción) y `multa`.
`simur`	Array	Multas del Sistema Integrado de Movilidad de Bogotá (SIMUR).
`rndc`	Array	Registro Nacional de Conductores de Carga.
`rnmc`	Object	Registro Nacional de Medidas Correctivas (Policía Nacional).
`profesion`	Object	Registros profesionales. Incluye `abogado`, `abogados_judicial`, `rethus`, `copnia`, `jcc`, `comvezcol`, `consejopro`, `cpae`, `cpbiol`, `cpiq`, `cpnt`, `cpqcol`, `conalpe`, `conaltel`, `colpsic`, `anec`.
`secop`	Array	Contratos públicos del SECOP I.
`secop2`	Array	Contratos públicos del SECOP II.
`secop_proveedores`	Array	Información de proveedores en SECOP.
`garantias_mobiliarias`	Array	Garantías mobiliarias registradas a nombre del titular.
`libreta_militar`	Object	Información de la libreta militar.
`contadores`	Array	Información en el registro de contadores públicos.
`fopep`	Object	Fondo de Pensiones Públicas (pensionados del régimen público).
`personeria_bogota`	Array	Antecedentes en la Personería de Bogotá.
`sisconmp`	Object	Sistema de Inhabilidades por Conductas de Maltrato y Pérdida de la Patria Potestad.

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​