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

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

Python

import requests

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

Node.js

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.

Validacón lista.

{
  "code": "XXXXXXXXX",
  "name": "1001001010",
  "email": "prueba@auco.ai",
  "data": {
      "name": "NAME NAME LAST NAME",
      "type": "CC",
      "identification": "1001001010",
      "expeditionDate": "01/01/1995"
  },
  "ready": true,
  "url": "https://amazon.url/file/signed-url"
}

Validacón pendiente.

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

⚠️ 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.