Geo Fencing_S
POST
https://api.staging.indiconnect.in/idverifygr/verification
Last modified:2026-10-05 11:34:49
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 'https://api.staging.indiconnect.in/idverifygr/verification' \
--header 'myAppId: verification_v4_app' \
--header 'service-key: sk_test_bf78b31a4b9275ca' \
--header 'Authorization: x-api-access indc_test_8cdbb53b09f50c3c:ac_test_bd6e115254f11a58' \
--header 'providercode: LLOK77FI' \
--header 'Content-Type: application/json' \
--data '"{
""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-10-05 11:34:49