Biometric validation

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

Service to obtain the similarity between an identity document and a person's photograph using AI algorithms, validating the authenticity of the photos.

Authentication

Include your private key in the Authorization header.

Authorization: prk_xxx...

Query parameters

Name	Description
country String	Required. Country of the person to validate. Check the list of documents and countries
type String	Required. Document type of the person to validate. Check the list of documents and countries
identification String	Required. Identification number of the person to query.
documentImage 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.
photo String	Required. Image of the person's face 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/validate' \
  -H 'Authorization: {{private_key}}' \
  -d '{
    "country": "CO",
    "type": "CC",
    "identification": "1001001010",
    "photo": "https://url.com/photo.jpg",
    "documentImage": "https://url.com/document.jpg"
  }'

Python

import requests

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

Node.js

const axios = require('axios');

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

📥 Example responses

Successful validation.

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

Failed validation.

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

⚠️ Error Responses

Code	Description
400	Missing parameters like photo or documentImage. Incorrect image format.
401	Invalid or missing authentication.