Mobile Verification
POST
https://api.staging.indiconnect.in/idverifygr/verification
Last modified:2026-04-01 08:00:27
This API checks whether the provided mobile number is active and retrieves important telecom details such as the connection type
(prepaid or postpaid), network provider, and country information.
customer onboarding, fraud prevention, and operational verification processes. By integrating this API,
businesses can validate mobile connections in real time and ensure that the provided number is legitimate
and associated with a valid telecom network.
related to the mobile number, including network name, connection type, portability status, and country details.
This allows organizations to verify telecom data quickly and integrate mobile verification seamlessly into their workflows.
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 that needs to be verified |
documentType | String | Specifies the verification type (Mobile Verification With OTP) |
Response Fields
| Field | Description |
|---|---|
ok | Indicates whether the verification was successful (true / false) |
message | Status message describing the verification result |
requestId | Unique identifier generated for the verification request |
msisdnCountryCode | Country code associated with the mobile number |
imsi | International Mobile Subscriber Identity related to the telecom network |
isValid | Indicates whether the mobile number is valid |
connectionTypes | Type of mobile connection (Prepaid or Postpaid) |
isPorted | Indicates whether the mobile number has been ported to another network |
networkName | Name of the telecom network provider |
countryCode | Country code of the mobile number |
countryName | Name of the country where the mobile number is registered |
error | Contains error details if verification fails |
Use Cases
- Mobile number verification during customer onboarding
- Fraud detection by validating telecom network details
- KYC verification processes in fintech and banking platforms
- Telecom data validation for operational and compliance purposes
Key Benefits
- Real-time mobile number verification
- Accurate identification of prepaid or postpaid connection types
- Reliable telecom network validation
- Easy integration with digital onboarding 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 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": "868b7350-f621-4187-b30a-2c0478726ca6",
"msisdnCountryCode": "IN",
"imsi": "4049098901",
"isValid": true,
"connectionTypes": "prepaid",
"isPorted": null,
"networkName": "Airtel // Maharashtra",
"countryCode": "IN",
"countryName": "India"
},
"error": null
}
}
}Modified at 2026-04-01 08:00:27