Face Liveness Passive
POST
https://api.staging.indiconnect.in/idverifygr/verification
Last modified:2026-04-06 06:27:01
Request Headers
| Header | Type | Required | Description |
|---|---|---|---|
| myAppId | String | Yes | Application identifier used for API authentication |
| service-key | String | Yes | Service key provided to access the verification service |
| Authorization | String | Yes | API authentication credentials |
| Content-Type | String | Yes | Request content type (application/json) |
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| documentType | String | Yes | Verification type (Face Liveness Passive) |
| url | String | Yes | Publicly accessible URL of the image containing the face to be analyzed |
Response Fields
| Field | Description |
|---|---|
| status_code | Status code representing the processing result of the liveness detection request |
| request_id | Unique identifier generated for the API request |
| case_id | Unique case reference ID generated for the liveness verification process |
| is_live | Indicates whether the detected face belongs to a live person (true or false) |
| liveness_score | Confidence score generated by the system indicating the probability that the face is live |
| review_needed | Indicates whether manual review is required for verification |
| multiple_faces_detected | Indicates whether multiple faces were detected in the provided image |
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_v4_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 Liveness Passive\"\r\n url: \"https://pg-all-js-assets.s3.ap-south-2.amazonaws.com/For_06.jpg\"\r\n }\r\n ) {\r\n ok\r\n message\r\n result {\r\n __typename\r\n ... on LivenessDetectionResult {\r\n status_code\r\n request_id\r\n case_id\r\n is_live\r\n liveness_score\r\n review_needed\r\n multiple_faces_detected\r\n }\r\n }\r\n error{\r\n message\r\n }\r\n }\r\n}",
"variables": {}
}'Response Response Example
200 - - Success
{
"data": {
"verify": {
"ok": true,
"message": "Verification completed successfully",
"result": {
"__typename": "LivenessDetectionResult",
"status_code": 103,
"request_id": "b9abbf40-e4de-46ea-8b17-6696722ba4ed",
"case_id": "LIVENESS-1774522626811",
"is_live": null,
"liveness_score": null,
"review_needed": null,
"multiple_faces_detected": null
},
"error": null
}
}
}Modified at 2026-04-06 06:27:01