Skip to main content

Query background check validation

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

Service to query a background check validation.

Authentication​

Include your public key in the Authorization header.

Authorization: puk_xxx...

Query Parameters​

NameDescription
code
String		Required.
Process code to query.

🧪 Usage examples​

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

📥 Example responses​

info

The ready property indicates whether the validation process has been completed or if the document is not yet ready. If the document is ready, the url property will be provided with the signed URL for downloading the document. Signed URLs are valid for 2 minutes before they expire.

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

Response fields​

FieldTypeDescription
codeStringUnique code of the validation process.
nameStringQueried identification number.
emailStringEmail address associated with the process.
urlStringSigned URL to download the PDF report. Only present when ready: true. Expires in 2 minutes.
readyBooleanIndicates whether the validation has been completed.
dataObjectBasic data of the queried person.
data.nameStringFull name of the person.
data.typeStringDocument type (e.g., CC, CE, PA).
data.identificationStringIdentification number.
data.expeditionDateStringDocument expedition date.
data.errorBooleanIndicates if there was an error in any query source.
data.reportsBooleanIndicates if negative reports were found.
validationObjectDetailed background check validation results. Only present when ready: true.

validation object fields​

FieldTypeDescription
contaduriaBooleanResult from the General Accounting Office (Contaduría General de la Nación) query.
contraloriaBooleanResult from the Comptroller General (Contraloría General de la República) query.
defuncionObjectDeath status information. Includes date, doc, and validity.
delitos_sexualesArrayRecords found in the sexual offenses database.
hallazgosObjectFindings classified by risk level.
hallazgos.altosArrayHigh-risk findings.
hallazgos.mediosArrayMedium-risk findings.
hallazgos.bajosArrayLow-risk findings.
hallazgos.infosArrayInformational findings (RUT, FOSYGA, RUAF, SISBEN, SENA, etc.). Do not represent risk.
nivelStringOverall risk level: alto (high), medio (medium), bajo (low), or info (no risk findings).
interpolBooleanResult from Interpol watchlist query.
ofacBooleanResult from OFAC sanctions list query.
policiaBooleanResult from police background check query.
proveedores_ficticiosBooleanResult from DIAN fictitious suppliers list query.
ramaObjectResults from judicial office (JEPMS) queries by city. Each key is a boolean.
rama_unificadaArrayUnified Judicial Branch judicial process results.
registraduriaObjectNational Registry (Registraduría Nacional) information. Includes cedula, estado, fecha_exp, lugar_exp, and nombre.
ruesObject | BooleanUnified Business and Social Registry (RUES) information. false if not registered.
rutStringUnified Tax Registry (RUT) number.
rut_estadoStringRUT status (e.g., REGISTRO ACTIVO).
nombreStringFull name of the holder according to the queried source.
generoStringReported gender (M / F).
tipo_documentoStringDocument type (e.g., CC, CE, PA).
fechaStringDate and time the report was generated.
errorBooleanIndicates whether any queried source returned an error. Details in errores.
erroresArray<String>List of sources that failed during the query (e.g., ["monteriajepms", "cartagenajepms"]).
fosygaObjectEPS affiliation information from the BDUA (FOSYGA). Includes entidad, estado, regimen, tipo_afiliado, fecha_afiliacion, fecha_finalizacion_afiliacion, departamento, municipio, among others.
lista_onuBooleanMatch in the United Nations consolidated sanctions list.
lista_banco_mundialObjectWorld Bank results. Includes debarred_firms_individuals and others_sanctions.
offshoreleaksObjectMatches in Offshore leaks. Contains Panama Papers, Pandora Papers, Paradise Papers, Bahamas Leaks, and Offshore Leaks.
europolArrayMatches in Europol lists.
iadbArrayMatches in the Inter-American Development Bank list.
cidobObjectMatches in the CIDOB database (biographies of political leaders).
ofac_nombreBooleanOFAC match by name.
ofac_resultadosBoolean | ArrayAdditional OFAC results.
pepsArrayMatches in PEP (Politically Exposed Persons) lists.
peps_denomArrayPEP matches by denomination.
procuraduriaArrayRecords from the Attorney General's Office (Procuraduría General de la Nación).
sigepObjectInformation from the Public Employment Information and Management System.
sirnaArrayMatches in the National Attorneys Registry Information System.
paco_onlineArrayResults from the Colombia Anti-Corruption Portal (PACO).
inpecObjectInformation from the National Penitentiary and Prison Institute.
insolvenciasArrayRegistered insolvency processes.
juzgados_tybaArrayJudicial processes in the Tyba system.
reputacionalObjectReputational information. Contains news (news items with title, link, sentimiento), social (social networks), and notable.
relacionadosArrayPersons related to the document holder.
ruafObjectUnified Registry of Affiliates. Includes affiliations to Salud, Pensiones, ARL, Cesantías, Caja de compensación, Pensionado, Programas de Asistencia Social, and Basico (basic data).
sisbenObjectSISBEN classification. Includes Grupo, Tipo de grupo, Departamento, Municipio, Estado, and Actualizacion Ciudadano.
senaArraySENA courses and certificates. Each element includes Programa, Tipo, Certificación, Registro, and Descarga.
simitObjectSIMIT information (traffic fines). Includes paz_salvo, cantidad_multas, multas, acuerdos_pagos, total_pagar, and cursos.
runtObjectRUNT information. Includes licencia (driver's licenses) and multa.
simurArrayBogotá Integrated Mobility System (SIMUR) fines.
rndcArrayNational Registry of Cargo Drivers.
rnmcObjectNational Registry of Corrective Measures (National Police).
profesionObjectProfessional registries. Includes abogado, abogados_judicial, rethus, copnia, jcc, comvezcol, consejopro, cpae, cpbiol, cpiq, cpnt, cpqcol, conalpe, conaltel, colpsic, anec.
secopArrayPublic contracts from SECOP I.
secop2ArrayPublic contracts from SECOP II.
secop_proveedoresArraySupplier information in SECOP.
garantias_mobiliariasArrayMovable guarantees registered under the holder's name.
libreta_militarObjectMilitary service card information.
contadoresArrayInformation in the public accountants registry.
fopepObjectPublic Pension Fund (public regime pensioners).
personeria_bogotaArrayRecords from the Bogotá Ombudsman's Office.
sisconmpObjectSystem of Disqualifications for Mistreatment and Loss of Parental Authority.

Finding structure​

Each element in hallazgos.altos, hallazgos.medios, hallazgos.bajos, and hallazgos.infos has the following structure:

FieldTypeDescription
cantidadStringNumber of matches found.
codigoStringIdentifier code of the finding type.
coincidenciaStringIndicates if there was a match ("True" / "False").
descripcionStringDetailed description of the finding.
fuenteStringInformation source.
hallazgoStringSummary of the finding.
html_idString | nullURL to download the finding detail, if applicable.

⚠️ Error Responses​

CodeDescription
400Missing parameters code.
Process not found VALIDATION_NOT_FOUND.
401Invalid or missing authentication.