Skip to main content
POST
/
auth
/
biometric
curl -X POST \
  "https://verilock.io/api/v1/auth/biometric" \
  -H "Authorization: Bearer qi_live_your_api_key_here" \
  -F "session_id=ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -F "file=@new_selfie.jpg" \
  -F "threshold=85"

{
  "id": "bio_f1e2d3c4-b5a6-9870-fedc-ba0987654321",
  "status": "processing",
  "message": "Biometric authentication started."
}
Compare a new selfie against the original selfie from an approved verification session. Ideal for step-up authentication, login verification, or high-value transaction confirmation.

​
Authenticate

​
session_id
string
required
The ID of an approved verification session to compare against.
​
file
file
required
New selfie image. Accepted: jpg, jpeg, png. Max: 10 MB.
​
threshold
number
Minimum similarity score to consider a match (50–100). Default: 80.
​
device_info
object
Optional device metadata (model, OS, IP).
curl -X POST \
  "https://verilock.io/api/v1/auth/biometric" \
  -H "Authorization: Bearer qi_live_your_api_key_here" \
  -F "session_id=ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -F "file=@new_selfie.jpg" \
  -F "threshold=85"

{
  "id": "bio_f1e2d3c4-b5a6-9870-fedc-ba0987654321",
  "status": "processing",
  "message": "Biometric authentication started."
}

​
Get Result

GET /v1/auth/biometric/{id}

{
  "id": "bio_f1e2d3c4-...",
  "session_id": "ses_a1b2c3d4-...",
  "result": "match",
  "similarity": 94.32,
  "liveness_score": 87.50,
  "liveness_passed": true,
  "threshold_used": 85.00,
  "created_at": "2026-03-16T14:30:00Z"
}

​
Result Values

ResultDescription
matchSimilarity meets threshold and liveness passed
no_matchSimilarity below threshold or liveness failed
errorProcessing error (no face detected, file corrupt)
pendingStill processing
Processing is asynchronous. Poll GET /auth/biometric/{id} or subscribe to the biometric.completed webhook event.