Mobile Verification with OTP
POST
https://api.staging.indiconnect.in/idverifygr/verification
Last modified:2026-04-01 09:38:49
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 |
|---|---|---|
mobileNumber | String | Mobile number to which the OTP will be sent for verification |
documentType | String | Specifies the verification type (Mobile Verification With OTP) |
Response Fields
| Field | Description |
|---|---|
ok | Indicates whether the verification request was successfully processed |
message | Status message describing the verification request result |
result.requestId | Unique identifier generated for the OTP verification request |
result.message | Confirmation message indicating that the OTP has been sent to the mobile number |
error | Contains error details if the verification request fails |
Use Cases
- OTP-based mobile number verification during user registration
- Customer onboarding and identity verification processes
- Secure login authentication using OTP
- Fraud prevention by validating user-owned mobile numbers
Key Benefits
- Real-time OTP-based mobile number verification
- Secure authentication using API credentials
- Improved user identity validation during onboarding
- Easy integration with web and mobile applications
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 mobileNumber: \"8999584397\"\r\n documentType: \"Mobile Verification With Otp\"\r\n }\r\n ) {\r\n ok\r\n message\r\n result {\r\n ... on MobileVerificationWithOtp{\r\n requestId\r\n message\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": {
"requestId": "55b8fa5e-2982-489a-aad5-0dcb24a3da1f",
"message": "Otp has been sent to your mobile number"
},
"error": null
}
}
}Modified at 2026-04-01 09:38:49