Consulter la validation de vérification des antécédents

GET/validate/backgroundclé publiquepuk_

Service permettant de consulter une validation de vérification des antécédents.

Authentification

Incluez votre clé publique dans l'en-tête Authorization.

Authorization: puk_xxx...

Paramètres de requête

Nom	Description
code String	Obligatoire. Code du processus à consulter.

🧪 Exemples d'utilisation

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));

📥 Exemples de réponse

info

La propriété ready indique si le processus de validation est terminé ou si le document n'est pas encore prêt. Si le document est prêt, la propriété url contiendra l'URL signée permettant de télécharger le document. Les URL signées sont valides pendant 5 minutes avant d'expirer.

Validation en attente.
Validation prête.

{
  "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": []
  }
}

Champs de la réponse

Champ	Type	Description
`code`	String	Code unique du processus de validation.
`name`	String	Numéro d'identification consulté.
`email`	String	Adresse e-mail associée au processus.
`url`	String	URL signée pour télécharger le rapport PDF. Présente uniquement lorsque `ready: true`. Expire au bout de 5 minutes.
`ready`	Boolean	Indique si la validation est terminée.
`data`	Object	Données de base de la personne consultée.
`data.name`	String	Nom complet de la personne.
`data.type`	String	Type de document (p. ex. `CC`, `CE`, `PA`).
`data.identification`	String	Numéro d'identification.
`data.expeditionDate`	String	Date de délivrance du document.
`data.error`	Boolean	Indique si une erreur s'est produite dans l'une des sources de consultation.
`data.reports`	Boolean	Indique si des signalements négatifs ont été trouvés.
`validation`	Object	Résultats détaillés de la validation des antécédents. Présent uniquement lorsque `ready: true`.

Champs de l'objet `validation`

Champ	Type	Description
`contaduria`	Boolean	Résultat de la consultation de la Contaduría General de la Nación (Contrôle général des comptes).
`contraloria`	Boolean	Résultat de la consultation de la Contraloría General de la República (Cour des comptes).
`defuncion`	Object	Informations sur le statut de décès. Inclut `date`, `doc` et `validity`.
`delitos_sexuales`	Array	Enregistrements trouvés dans la base de données des délits sexuels.
`hallazgos`	Object	Résultats classés par niveau de risque.
`hallazgos.altos`	Array	Résultats à risque élevé.
`hallazgos.medios`	Array	Résultats à risque moyen.
`hallazgos.bajos`	Array	Résultats à risque faible.
`hallazgos.infos`	Array	Résultats informatifs (RUT, FOSYGA, RUAF, SISBEN, SENA, etc.). Ne représentent pas un risque.
`nivel`	String	Niveau de risque global : `alto` (élevé), `medio` (moyen), `bajo` (faible) ou `info` (aucun résultat à risque).
`interpol`	Boolean	Résultat de la consultation de la liste de surveillance d'Interpol.
`ofac`	Boolean	Résultat de la consultation de la liste de sanctions de l'OFAC.
`policia`	Boolean	Résultat de la consultation des antécédents de police.
`proveedores_ficticios`	Boolean	Résultat de la consultation de la liste des fournisseurs fictifs de la DIAN.
`rama`	Object	Résultats des consultations des tribunaux (JEPMS) par ville. Chaque clé est un booléen.
`rama_unificada`	Array	Résultats des procédures judiciaires de la Rama Judicial unifiée.
`registraduria`	Object	Informations de la Registraduría Nacional (état civil). Inclut `cedula`, `estado`, `fecha_exp`, `lugar_exp` et `nombre`.
`rues`	Object \| Boolean	Informations du Registre unique des entreprises et du social (RUES). `false` si la personne n'est pas enregistrée.
`rut`	String	Numéro du Registre unique des impôts (RUT).
`rut_estado`	String	Statut du RUT (p. ex. `REGISTRO ACTIVO`).
`nombre`	String	Nom complet du titulaire selon la source consultée.
`genero`	String	Genre déclaré (`M` / `F`).
`tipo_documento`	String	Type de document (p. ex. `CC`, `CE`, `PA`).
`fecha`	String	Date et heure de génération du rapport.
`error`	Boolean	Indique si une source consultée a renvoyé une erreur. Détails dans `errores`.
`errores`	Array<String>	Liste des sources ayant échoué lors de la consultation (p. ex. `["monteriajepms", "cartagenajepms"]`).
`fosyga`	Object	Informations d'affiliation à l'EPS provenant de la BDUA (FOSYGA). Inclut `entidad`, `estado`, `regimen`, `tipo_afiliado`, `fecha_afiliacion`, `fecha_finalizacion_afiliacion`, `departamento`, `municipio`, entre autres.
`lista_onu`	Boolean	Correspondance dans la liste consolidée de sanctions des Nations unies.
`lista_banco_mundial`	Object	Résultats de la Banque mondiale. Inclut `debarred_firms_individuals` et `others_sanctions`.
`offshoreleaks`	Object	Correspondances dans les Offshore Leaks. Contient `Panama Papers`, `Pandora Papers`, `Paradise Papers`, `Bahamas Leaks` et `Offshore Leaks`.
`europol`	Array	Correspondances dans les listes d'Europol.
`iadb`	Array	Correspondances dans la liste de la Banque interaméricaine de développement.
`cidob`	Object	Correspondances dans la base de données du CIDOB (biographies de dirigeants politiques).
`ofac_nombre`	Boolean	Correspondance OFAC par nom.
`ofac_resultados`	Boolean \| Array	Résultats OFAC supplémentaires.
`peps`	Array	Correspondances dans les listes de PPE (personnes politiquement exposées).
`peps_denom`	Array	Correspondances PPE par dénomination.
`procuraduria`	Array	Enregistrements de la Procuraduría General de la Nación (Procureur général).
`sigep`	Object	Informations du Système d'information et de gestion de l'emploi public.
`sirna`	Array	Correspondances dans le Système d'information du registre national des avocats.
`paco_online`	Array	Résultats du Portail anticorruption de Colombie (PACO).
`inpec`	Object	Informations de l'Institut national pénitentiaire et carcéral.
`insolvencias`	Array	Procédures d'insolvabilité enregistrées.
`juzgados_tyba`	Array	Procédures judiciaires dans le système Tyba.
`reputacional`	Object	Informations de réputation. Contient `news` (actualités avec `title`, `link`, `sentimiento`), `social` (réseaux sociaux) et `notable`.
`relacionados`	Array	Personnes liées au titulaire du document.
`ruaf`	Object	Registre unique des affiliés. Inclut les affiliations à `Salud`, `Pensiones`, `ARL`, `Cesantías`, `Caja de compensación`, `Pensionado`, `Programas de Asistencia Social` et `Basico` (données de base).
`sisben`	Object	Classification SISBEN. Inclut `Grupo`, `Tipo de grupo`, `Departamento`, `Municipio`, `Estado` et `Actualizacion Ciudadano`.
`sena`	Array	Cours et certificats du SENA. Chaque élément inclut `Programa`, `Tipo`, `Certificación`, `Registro` et `Descarga`.
`simit`	Object	Informations du SIMIT (amendes de circulation). Inclut `paz_salvo`, `cantidad_multas`, `multas`, `acuerdos_pagos`, `total_pagar` et `cursos`.
`runt`	Object	Informations du RUNT. Inclut `licencia` (permis de conduire) et `multa`.
`simur`	Array	Amendes du Système intégré de mobilité de Bogotá (SIMUR).
`rndc`	Array	Registre national des conducteurs de transport de marchandises.
`rnmc`	Object	Registre national des mesures correctives (Police nationale).
`profesion`	Object	Registres professionnels. Inclut `abogado`, `abogados_judicial`, `rethus`, `copnia`, `jcc`, `comvezcol`, `consejopro`, `cpae`, `cpbiol`, `cpiq`, `cpnt`, `cpqcol`, `conalpe`, `conaltel`, `colpsic`, `anec`.
`secop`	Array	Marchés publics du SECOP I.
`secop2`	Array	Marchés publics du SECOP II.
`secop_proveedores`	Array	Informations sur les fournisseurs dans le SECOP.
`garantias_mobiliarias`	Array	Garanties mobilières enregistrées au nom du titulaire.
`libreta_militar`	Object	Informations du livret militaire.
`contadores`	Array	Informations du registre des comptables publics.
`fopep`	Object	Fonds de retraite publique (retraités du régime public).
`personeria_bogota`	Array	Enregistrements de la Personería (médiateur) de Bogotá.
`sisconmp`	Object	Système des inhabilitations pour mauvais traitements et perte de l'autorité parentale.

Structure d'un résultat

Chaque élément de hallazgos.altos, hallazgos.medios, hallazgos.bajos et hallazgos.infos a la structure suivante :

Champ	Type	Description
`cantidad`	String	Nombre de correspondances trouvées.
`codigo`	String	Code identifiant le type de résultat.
`coincidencia`	String	Indique s'il y a eu correspondance (`"True"` / `"False"`).
`descripcion`	String	Description détaillée du résultat.
`fuente`	String	Source d'information.
`hallazgo`	String	Résumé du résultat.
`html_id`	String \| null	URL pour télécharger le détail du résultat, le cas échéant.

⚠️ Réponses d'erreur

Code	Description
400	Paramètre `code` manquant. Processus introuvable `VALIDATION_NOT_FOUND`.
401	Authentification invalide ou manquante.

Authentification​

Paramètres de requête​

🧪 Exemples d'utilisation​

📥 Exemples de réponse​

Champs de la réponse​

Champs de l'objet validation​

Structure d'un résultat​

⚠️ Réponses d'erreur​