Mobile Verification with OTP details
POST
https://api.staging.indiconnect.in/idverifygr/verification
Last modified:2026-04-01 10:10:17
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 |
|---|---|---|
requestId | String | Unique request ID generated during the OTP verification process |
documentType | String | Specifies the verification type (Mobile Verification With Details) |
Response Fields
| Field | Description |
|---|---|
ok | Indicates whether the verification process was successful |
message | Status message describing the verification result |
identity.name | Name of the individual associated with the verified mobile number |
identity.dateOfBirth | Date of birth of the mobile number subscriber |
simDetails.provider | Name of the telecom service provider associated with the mobile number |
simDetails.otpValidated | Indicates whether the OTP verification process was successfully completed |
error | Contains error details if verification fails |
Use Cases
- Customer identity verification during onboarding
- KYC verification using verified mobile numbers
- Fraud prevention through telecom identity validation
- Subscriber information verification for fintech and telecom platforms
Key Benefits
- Secure OTP-based mobile ownership authentication
- Reliable retrieval of subscriber identity information
- Real-time telecom provider validation
- Easy integration with digital onboarding and KYC systems
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_v1' \
--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 requestId: \"55b8fa5e-2982-489a-aad5-0dcb24a3da1f\"\r\n documentType: \"Mobile Verification With Details\"\r\n }\r\n ) {\r\n ok\r\n message\r\n result {\r\n ... on MobileVerificationWithDetails {\r\n identity {\r\n name\r\n dateOfBirth\r\n }\r\n simDetails {\r\n provider\r\n otpValidated\r\n }\r\n }\r\n }\r\n error {\r\n status\r\n message\r\n decryptedError\r\n }\r\n }\r\n}\r\n",
"variables": {}
}'Response Response Example
200 - - Success
{
"data": {
"verify": {
"ok": true,
"message": "Verification completed successfully",
"result": {
"identity": {
"name": "Jadhav Prakash Ramesh",
"dateOfBirth": "19-03-1998"
},
"simDetails": {
"provider": "airtel",
"otpValidated": true
}
},
"error": null
}
}
}Modified at 2026-04-01 10:10:17