Mobile Verification with OTP Verify
POST
https://api.staging.indiconnect.in/idverifygr/verification
Last modified:2026-04-06 06:27:00
OTP (One-Time Password) validation and retrieve associated telecom details after successful verification.
This API acts as the second step in the OTP verification workflow, where the OTP sent to the user's mobile
number is validated using the previously generated request ID.
and confirms the verification status. This enables organizations to ensure that the mobile number belongs
to the user performing the verification while also retrieving telecom information required for operational
and compliance purposes.
during OTP initiation and the OTP received by the user, organizations can validate mobile number ownership
and retrieve network provider information reliably and securely.
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 initiation step |
otp | String | One-Time Password received by the user on the registered mobile number |
documentType | String | Specifies the verification type (mobile verification with status) |
Response Fields
| Field | Description |
|---|---|
ok | Indicates whether the verification process was successful |
message | Status message describing the verification result |
result.provider | Name of the telecom service provider associated with the mobile number |
result.otpValidate | Indicates whether the provided OTP was successfully validated |
error | Contains error details if verification fails |
Use Cases
- OTP-based mobile ownership verification
- Secure user authentication during onboarding
- Fraud prevention through mobile verification
- Telecom provider identification after OTP validation
Key Benefits
- Secure OTP-based mobile number authentication
- Reliable verification of mobile ownership
- Real-time telecom provider identification
- Easy integration with digital onboarding and verification 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: \"0f45c4fc-9a2e-4ca0-b1b0-978a6a733705\"\r\n otp: \"902501\"\r\n documentType: \"mobile verification with status\"\r\n }\r\n ) {\r\n ok\r\n message\r\n result {\r\n ... on MobileVerificationWithStatus{\r\n provider\r\n otpValidate\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
{
"data": {
"verify": {
"ok": true,
"message": "Verification completed successfully",
"result": {
"provider": "airtel",
"otpValidate": null
},
"error": null
}
}
}Modified at 2026-04-06 06:27:00