Face Match
POST
https://api.staging.indiconnect.in/idverifygr/verification
Last modified:2026-04-03 06:39:09
It provides a reliable and automated approach to identity verification.
By leveraging facial recognition technology, businesses can ensure accurate matching and reduce the risk of identity fraud.
match result, similarity score, confidence level, and review indicators.
Request Headers
| Header | Description |
|---|---|
myAppId | Application identifier used for service authentication |
service-key | Unique service key provided for accessing the verification service |
Authorization | API authorization credentials for secure access |
Content-Type | Specifies the request payload format (application/json) |
Request Parameters
| Parameter | Type | Description |
|---|---|---|
url1 | String | URL of the first image (KYC document or photograph) |
url2 | String | URL of the second image to compare |
documentType | String | Specifies the verification type (face match) |
Response Fields
| Field | Description |
|---|---|
ok | Indicates whether the request was successful (true / false) |
message | Status message describing the result |
result.match | Indicates whether the faces match (yes / no) |
result.match_score | Similarity score between the two faces |
result.confidence | Confidence level of the match result |
result.review_needed | Indicates if manual review is required (yes / no) |
error | Contains error details if the request fails |
Use Cases
- KYC identity verification
- Fraud detection and prevention
- User onboarding and authentication
- Verification across multiple identity documents
Key Benefits
- Accurate facial recognition and matching
- Reduces identity fraud risks
- Automated and fast verification process
- Easy integration into KYC workflows
Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.staging.indiconnect.in/idverifygr/verification' \
--header 'myAppId: verification_v3_app' \
--header 'service-key: sk_test_a9944179bc598f06' \
--header 'Authorization: x-api-access indc_test_a41eaf2a175f3b13:ac_test_bf7117f6da6c6285' \
--header 'Content-Type: application/json' \
--data-raw '{
"query": "mutation {\r\n verify(\r\n input: {\r\n documentType: \"face match\"\r\n url1: \"https://img.freepik.com/free-photo/portrait-happy-smiley-man_23-2149022627.jpg\"\r\n url2: \"https://img.freepik.com/premium-photo/image-happy-young-excited-emotional-man-posing-isolated-white-wall_171337-101232.jpg\"\r\n }\r\n ) {\r\n ok\r\n message\r\n result {\r\n __typename\r\n ... on FaceMatchResult {\r\n match\r\n match_score\r\n confidence\r\n review_needed\r\n }\r\n }\r\n error {\r\n message\r\n }\r\n }\r\n}\r\n",
"variables": {}
}'Response Response Example
200 - Success - Success
{
"data": {
"verify": {
"ok": true,
"message": "Verification completed successfully",
"result": {
"__typename": "FaceMatchResult",
"match": "no",
"match_score": 4.242369565217391,
"confidence": 96.05198502540588,
"review_needed": "no"
},
"error": null
}
}
}Modified at 2026-04-03 06:39:09