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

🧪 Usage examples

Curl

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

📥 Example responses

Successful validation.

{
  "error": false,
  "text": "42",
  "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,
  "text": "",
  "similarity": 49.4231344,
  "code": "JPJD42IDWP3Z6RXA",
  "identificationCard": {
    "error": true,
    "message": "DOCUMENT_FAKE",
    "isFront": false,
    "data": { }
  }
}

⚠️ Error Responses

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