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

📥 Example responses

Successful validation.

{
  "error": false,
  "similarity": 89.46871185302734,
  "code": "JPJD42IDWP3Z6RXA"
}

Failed validation.

{
  "error": true,
  "similarity": 49.4231344,
  "code": "JPJD42IDWP3Z6RXA"
}

🧪 Usage examples

Curl

curl -X POST '{{api_auco}}/veriface/validate' \
  -H 'Authorization: {{private_key}}' \
  -d '{
    "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={
    "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', {
  photo: 'https://url.com/photo.jpg',
  documentImage: 'https://url.com/document.jpg'
}, {
  headers: { Authorization: '{{private_key}}' }
})
.then((response) => console.log(response.data));

⚠️ Error Responses

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