Skip to content
Finovel
API documentation

Face Match

Compare a selfie and ID image with confidence scoring.

Endpoint

POST https://api.finovel.in/v1/face-match

Charged only when the call succeeds. Errors are never charged. See how every API works for keys, retries and status codes.

Request fields

FieldTypeRequiredDescription
selfiefileYesSelfie
id_cardfileYesID Card

Example request

curl -X POST https://api.finovel.in/v1/face-match \
  -H "Authorization: Bearer fin_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{}'

Response fields

Inside data:

FieldDescription
match_statusMatch
confidenceConfidence

Example response from the sandbox

{
  "request_id": "req_...",
  "success": true,
  "status": "success",
  "environment": "sandbox",
  "message": "OK",
  "data": {
    "confidence": 0.94,
    "match_status": "success"
  },
  "error": null,
  "charged_paise": 0
}

Sandbox scenarios

With a test key, this API can return:

  • Success (default)