Background checks in Colombia [⚠️DEPRECATED]

danger

This service is deprecated. Migration to the Generate Background Check service is recommended.

Service to perform user queries and validate them in Colombian national lists such as Judicial Records, Attorney General's Records, Comptroller's Records and Police Records.

POST /validate/backgroundCheck/co HTTP/1.1
HOST: {{api_auco}}
Authorization: {{private_key}}

info

This service uses the company's private key.

Name	Description
email String	Required. Email of the process creator. This email must be registered on the Auco platform and must belong to the company.
identification String	Required. Identification number of the person to be consulted.
restrictiveLists Array<String>	Required. List of lists of entities where background checks will be carried out. Accepted values: procuraduriaRecords, judicialRecords, policeRecords, contraloriaRecords
targetWebhooks Array<String>	Optional. List of webhooks to be notified. If not defined, it will be sent to the "default" webhook.
tags Array<String>	Optional. List of tags to be sent when notifying the configured webhooks.

Responses

200: Successful query.

{
  "name": "NOMBRE",
  "documentType": "CC",
  "documentNumber": "NÚMERO DE DOCUMENTO",
  "procuraduriaRecords": {
    "legend": "Consulta en línea de Antecedentes Disciplinarios, La Procuraduria General de la Nacion certifica Que siendo las x horas del DD/MM/AAAA el Señor(a) NOMBRE identificado(a) con Cédula de ciudadanía Número #### El ciudadano no presenta antecedentes."
  },
  "judicialRecords": {
    "name": "nombere",
    "processNum": "# de procesos encontrados",
    "details": [
      {
        "idProceso": 1000,
        "idConexion": 10,
        "llaveProceso": "",
        "fechaProceso": "DD/MM/AAAA",
        "fechaUltimaActuacion": "DD/MM/AAAA",
        "despacho": "JUZGADO ###",
        "departamento": "DEPARTAMENTO",
        "sujetosProcesales": [
          "Demandante: NOMBRE",
          "Demandado: NOMBRE",
          "Ministerio Pùblico: "
        ],
        "esPrivado": false
      }
    ]
  },
  "policeRecords": "NO TIENE ASUNTOS PENDIENTES CON LAS AUTORIDADES JUDICIALES\nde conformidad con lo establecido en el artículo 248 de la Constitución Política de Colombia. \n\nEn cumplimiento de la Sentencia SU-458 del 21 de junio de 2012, proferida por la Honorable Corte Constitucional, la leyenda “NO TIENE ASUNTOS PENDIENTES CON LAS AUTORIDADES JUDICIALES” aplica para todas aquellas personas que no registran antecedentes y para quienes la autoridad judicial competente haya decretado la extinción de la condena o la prescripción de la pena. ",
  "contraloriaRecords": "CONTRALORÍA GENERAL DE LA REPUBLICA LA CONTRALORÍA DELEGADA PARA RESPONSABILIDAD FISCAL, , INTERVENCIÓN JUDICIAL Y COBRO COACTIVO CERTIFICA: Que una vez consultado el Sistema de Información del Boletín de Responsables Fiscales 'SIBOR', hoy DIA_DE_LA_SEMANA DD de MM de AAAA, a las x, el número de identificación, relacionado a continuación, NO SE ENCUENTRA REPORTADO COMO RESPONSABLE FISCAL. Tipo Documento Cédula de Ciudadanía No. Identificación ##### Código de Verificación ##########",
  "code": "######"
}

Example

HTTP

POST /validate/backgroundCheck/co HTTP/1.1
Host: {{api_auco}}
Authorization: {{private_key}}
{
  "email": "prueba@auco.ai",
  "identification": "1000100100",
  "restrictiveLists": [
    "procuraduriaRecords",
    "judicialRecords",
    "policeRecords",
    "contraloriaRecords"
  ]
}

Node

var axios = require('axios');

axios.post('{{api_auco}}/validate/backgroundCheck/co', {
  email: "prueba@auco.ai",
  identification: "1000100100",
  restrictiveLists: [
    "procuraduriaRecords",
    "judicialRecords",
    "policeRecords",
    "contraloriaRecords"
  ]
}, {
  headers: {
    Authorization: '{{private_key}}'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error(error);
});