Check document

POST /veriface/check HTTP/1.1
HOST: {{api_auco}}
Authorization: {{private_key}}

Service to validate an identity document, determine whether it belongs to the number provided, whether it is falsified and extract data using OCR.

Authentication

Include your private key in the Authorization header.

Authorization: prk_xxx...

Query parameters

Name	Description
country String	Required. Country of the person to be validated. Check list of documents and countries
type String	Required. Type of document of the person to be validated. Check list of documents and countries
identification String	Required. Identification number of the person to be consulted.
image String	Required. Image of the document in base64 or the public URL to access the image. The image must be in JPEG or PNG format.

🧪 Usage examples

Curl

curl -X POST '{{api_auco}}/veriface/check' \
  -H 'Authorization: {{private_key}}' \
  -d '{
    "country": "CO",
    "type": "CC",
    "identification": "1001001010",
    "image": "https://url.com/document.jpg"
  }'

Python

import requests

response = requests.post(
  '{{api_auco}}/veriface/check',
  headers={'Authorization': '{{private_key}}'},
  json={
    "country": "CO",
    "type": "CC",
    "identification": "1001001010",
    "image": "https://url.com/document.jpg"
  }
)
print(response.json())

Node.js

const axios = require('axios');

axios.post('{{api_auco}}/veriface/check', {
  country: "CO",
  type: "CC",
  identification: "1001001010",
  image: "https://url.com/document.jpg"
}, {
  headers: { Authorization: '{{private_key}}' }
})
.then((response) => console.log(response.data));

📥 Example responses

Successful validation.

{
  "code": "JPJD42IDWP3Z6RXA",
  "error": false,
  "isFront": true,
  "data": {
    "bloodGroup": "O+",
    "dateOfBirth": "1990-01-01",
    "dateOfExpiry": "2030-01-01",
    "firstIssueDate": "01 SEPT 2000 BOGOTÁ D.C. ",
    "fullName": "DOE DOE JHON MICHEL",
    "givenNames": "JHON MICHEL",
    "height": "170 cm",
    "issuingStateName": "Colombia",
    "nationality": "Colombia",
    "nationalityCode": "COL",
    "personalNumber": "1001001010",
    "placeOfBirth": "BOGOTÁ D.C. (CUNDINAMARCA)",
    "sex": "M",
    "surname": "DOE DOE",
    "documentType": "Id Card",
    "name": "JHON MICHEL DOE DOE"
  }
}

Failed validation.

{
  "code": "JPJD42IDWP3Z6RXA",
  "error": true,
  "message": "DOCUMENT_FAKE",
  "isFront": false,
  "data": { }
}

⚠️ Error Responses

Code	Description
400	Missing parameters like country, type, identification or image. Incorrect image format.
401	Invalid or missing authentication.