Biometric validation with video

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

Service to obtain the similarity between an identity document and the person's video using AI algorithms, also obtaining the text or number that the person says.

Authentication

Include your private key in the Authorization header.

Authorization: prk_xxx...

Query parameters

Name	Description
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.
video String	Required. Public URL of the person's face video.

📥 Example responses

Successful validation.

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

Failed validation.

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

🧪 Usage examples

Curl

curl -X POST '{{api_auco}}/veriface/validate/video' \
  -H 'Authorization: {{private_key}}' \
  -d '{
    "documentImage": "https://url.com/document.jpg",
    "video": "https://url.com/video.mp4"
  }'

Python

import requests

response = requests.post(
  '{{api_auco}}/veriface/validate/video',
  headers={'Authorization': '{{private_key}}'},
  json={
    "documentImage": "https://url.com/document.jpg",
    "video": "https://url.com/video.mp4"
  }
)
print(response.json())

Node.js

const axios = require('axios');

axios.post('{{api_auco}}/veriface/validate/video', {
  documentImage: 'https://url.com/document.jpg',
  video: 'https://url.com/video.mp4'
}, {
  headers: { Authorization: '{{private_key}}' }
})
.then((response) => console.log(response.data));

⚠️ Error Responses

Code	Description
400	Missing parameters like documentImage or video. Incorrect file format.
401	Invalid or missing authentication.