Geo Fencing

The Geofencing API is a remarkable REST API that offers a plethora of features to enhance location-based services. With its seamless integration and powerful functionality, it brings a new level of precision and intelligence to the world of IP geolocation. First and foremost, this API grants you the ability to effortlessly determine the location and address associated with any given IP address. Whether you need to identify the whereabouts of a user or simply want to gather geographical data, this API provides accurate and up-to-date information to meet your needs. By harnessing the power of this API, you can unlock a wealth of possibilities in various domains, including e-commerce, targeted marketing, fraud prevention, and much more. But that's not all! The Geofencing API goes beyond mere location identification. It also empowers you with the capability to assess whether a particular IP address is deemed risky or not. This invaluable feature acts as a safeguard, allowing you to detect potential threats or suspicious activities in real-time. By leveraging this API, you can proactively protect your systems, users, and sensitive data from unauthorized access or malicious intent. One of the standout aspects of this API is its versatility. It accommodates IP addresses from all countries, ensuring that you can seamlessly operate on a global scale. Regardless of where your users are located or the nature of your application, the Geofencing API supports your requirements with precision and efficiency. In conclusion, the Geofencing API is a game-changer when it comes to IP geolocation services. Its RESTful design and comprehensive functionality make it a must-have tool for developers, businesses, and organizations alike. With its ability to provide accurate location information, assess risk levels, and support all countries, this API empowers you to unlock the true potential of geolocation data, enabling you to make informed decisions, enhance user experiences, and fortify your systems against potential threats.

Authentication

You will need to login before sending ID Intelligence request. You are required to pass the access token received from the login call, as authorization header in the ID Intelligence request .

Endpoint

Test Environment

POST https://preproduction.signzy.tech/api/v2/patrons/..patronID../riskscores

Production Environment

POST https://signzy.tech/api/v2/patrons/...patronID.../riskscores

Note: Replace ...patronID... with your actual patron ID

Headers

Key	Value
Authorization	access token (returned as id field of login request)
Content-type	application/json

Request Body

The request body should be in JSON format and include the following parameters:

{
  "task": "geoFencing",
  "essentials": {
    "ip": "...ip address...",
    "country": "...2 digit ISO country code...",
    "state": "...State code for the country (allowed only if the state input is supported for the country)..."
  }
}

Field	Description
task	The value should be "geoFencing"
ip	The IP address for which geo-location information is requested.
country	The 2-digit ISO country code for the location associated with the IP address.
state	The state code for the country (only allowed if the state input is supported for the country).

Response

The API response will be in JSON format and will include the following fields:

{
  "result": {
    "ip": "...ip address...",
    "country": "...country...",
    "countryCode": "ISO 2 digit country code...",
    "state": "...state...",
    "stateCode": "...state code...",
    "city": "...city...",
    "zipCode": "...zipcode...",
    "timezone": "...timezone...",
    "latitude": "...latitude...",
    "longitude": "...longitude...",
    "asn": "...asn...",
    "riskyIp": true/false,
    "validUser": true/false
  }
}

Field	Description
result	Contains the geolocation information and other details for the IP address.
ip	The IP address.
country	The country associated with the IP address.
countryCode	The 2-digit ISO country code.
state	The state associated with the IP address.
stateCode	The state code.
city	The city associated with the IP address.
zipCode	The postal code/zipCode for the location.
timezone	The timezone of the location.
latitude	The latitude coordinate of the location.
longitude	The longitude coordinate of the location.
asn	The Autonomous System Number associated with the IP address.
riskyIp	Indicates whether the IP address is considered risky.
validUser	Indicates whether the user is considered valid.