Face Verification API

Verify a live face image against an ID or profile image in real time. Ideal for KYC, user onboarding, access control, and fraud prevention.

Overview

This API compares two face images and returns a similarity score along with a decision. Designed to run in real-time with low latency and high accuracy across global regions.

Authentication

All requests must include the API key in the header:

bash

curl -H "Authorization: Bearer YOUR_API_KEY"

Endpoint

POST /v1/face-verification/verify

json

{
          "image1_base64": "...", // ID or profile image
          "image2_base64": "..."  // Live selfie image
        }

Response

json

{
          "match": true,
          "score": 0.9921,
          "threshold": 0.85,
          "message": "Face verified successfully"
        }

Error Codes

401 Unauthorized – Invalid API key
400 Bad Request – Missing or invalid image inputs
429 Too Many Requests – Rate limit exceeded
500 Internal Server Error – Processing error or timeout

Example Request

bash

curl -X POST https://api.someapis.com/v1/face-verification/verify         -H "Authorization: Bearer YOUR_API_KEY"         -H "Content-Type: application/json"         -d '{         "image1_base64": "data:image/jpeg;base64,...",
        "image2_base64": "data:image/jpeg;base64,..."
      }'

Use Cases

KYC onboarding (banking, fintech, insurance)
Online exam proctoring
Access control (secure doors, apps)
Multi-device identity sync