Geo Fencing_S
POST
https://api.staging.indiconnect.in/idverifygr/verification
Last modified:2026-04-02 13:32:50
It provides precise insights into the origin of an IP address, helping identify potential mismatches or suspicious activity.
By integrating this API, organizations can validate whether a user’s location aligns with expected geographic boundaries and detect high-risk IP activity.
IP location details, geolocation coordinates, timezone, and risk indicators associated with the provided IP address.
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 |
|---|---|---|
idNumber | String | IP address used as a unique identifier for geolocation verification |
ip | String | IP address to retrieve geolocation details |
country | String | Expected country code (e.g., IN for India) |
state | String | Expected state code (e.g., MH for Maharashtra) |
task | String | Specifies the operation type (geoFencing) |
documentType | String | Specifies the verification type (Geo Fencing_S) |
Response Fields
| Field | Description |
|---|---|
ok | Indicates whether the verification was successful (true / false) |
message | Status message describing the verification result |
result.task | Type of task performed (geoFencing) |
result.id | Unique identifier for the request |
result.patron_id | Internal reference ID for tracking |
result.essentials.ip | IP address used in the request |
result.essentials.country | Expected country provided in input |
result.essentials.state | Expected state provided in input |
result.data.ip | Resolved IP address |
result.data.country | Detected country name |
result.data.country_code | Detected country code |
result.data.state | Detected state name |
result.data.state_code | Detected state code |
result.data.city | Detected city of the IP location |
result.data.zip_code | Postal/ZIP code of the location |
result.data.timezone | Timezone associated with the IP location |
result.data.latitude | Latitude coordinate of the location |
result.data.longitude | Longitude coordinate of the location |
result.data.asn | Autonomous System Number associated with the IP |
result.data.risk_ip | Indicates whether the IP is flagged as risky (true / false) |
result.data.valid_user | Indicates whether the user is considered valid based on geolocation checks |
error | Contains error details if verification fails |
Use Cases
- Fraud detection using IP location mismatch
- Geo-restriction enforcement for applications
- User location validation during onboarding
- Risk scoring based on IP intelligence
Key Benefits
- Accurate IP-based geolocation insights
- Enhanced fraud detection capabilities
- Supports real-time risk assessment
- Easy integration for location-based services
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: \"Geo Fencing_S\"\r\n idNumber:\"27.107.46.10\"\r\n task: \"geoFencing\"\r\n ip: \"27.107.46.10\"\r\n country: \"IN\"\r\n state: \"MH\"\r\n }\r\n ) {\r\n ok\r\n message\r\n result {\r\n __typename\r\n ... on RiskScoreGeoFencingResult {\r\n task\r\n id\r\n patron_id\r\n\r\n essentials {\r\n ip\r\n country\r\n state\r\n patron_id\r\n }\r\n\r\n data {\r\n ip\r\n country\r\n country_code\r\n state\r\n state_code\r\n city\r\n zip_code\r\n timezone\r\n latitude\r\n longitude\r\n asn\r\n risk_ip\r\n valid_user\r\n }\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": {
"__typename": "RiskScoreGeoFencingResult",
"task": "geoFencing",
"id": "69c66ac603d4830023207700",
"patron_id": "64d49c02980af6002257a42e",
"essentials": {
"ip": "27.107.46.10",
"country": "IN",
"state": "MH",
"patron_id": "64d49c02980af6002257a42e"
},
"data": {
"ip": "27.107.46.10",
"country": "INDIA",
"country_code": "IN",
"state": "TAMIL NADU",
"state_code": "TN",
"city": "CHENNAI",
"zip_code": "600006",
"timezone": "IST, Asia/Kolkata",
"latitude": 13.0524087,
"longitude": 80.250942,
"asn": "17762",
"risk_ip": false,
"valid_user": false
}
},
"error": null
}
}
}Modified at 2026-04-02 13:32:50