We provide a set of REST API that lets you create, update, get, and delete Users, events, location, trips and Geofences, which will help you to do more with our product.
This page describes our authentication model, API endpoints and error handling while using our apis.
All URLs referenced in the API documentation will have the following base:
REST APIs are served over HTTPS. To ensure data privacy, we discourage using unencrypted HTTP requests.
Quickly learn to start using our APIs through API Quickstart Guide .
Here are some popular use cases with our API:
We use a basic authentication for the APIs taking into consideration the safety of your API secret keys. We provide APIs on a per project basis so that other projects remain unaffected in the uneventful case of one projects API being compromised.
Once your application is integrated with Geofence SDK, account for each user using your app will be created. Information about these users can be tracked through our APIs.
Here are the API endpoints available to interact with the user profile data:
The Get User API lets you download user data chronologically, which gives you a lot of useful information such as which application the user is using, the device they are using (iOS or Android), whether the user is deleted or not, and when they joined your app.
The Get Location API lets you download user location data chronologically. The response also has other useful info such as battery percentage, activity status, recorded time of the location, etc which can give useful insights about the user.
This set of APIs lets you create, get, update, and delete geofences, specific to the project and helps you to keep track of them . The same operation can be performed from the website dashboard as well.
They also allow you to enable these geofences for triggering events.
Note: By default, GeoFences are not "event trigger" enabled. To make a geofence "event trigger" enabled, update that particular geofence using Update API and pass the below option.
The Get Events API lets you download the events of entry or exit of your users from your event enabled geofences. The API also lets you filter user wise or geofence wise, or location wise and other options detailed in the API Quickstart guide below .
The Get Trips API lets you download the trips data of all active ongoing and completed trips for your users.
The Get trips route api lets you download the trip's "route specific data" for the completed trips . This will give the path/route taken by the user for trips.