List Geofences in Enterprise

List Geofences in Enterprise
Legacy

Request

Legacy endpoint. Android only. Geofence configuration is now managed through blueprints. Use the blueprints endpoints (/api/v2/blueprints/) to create and manage geofences going forward.

Returns a paginated list of all geofences defined within the enterprise.Use this endpoint to audit existing legacy geofence definitions — their coordinates, radii, and configured device actions — before migrating configurations to blueprints.

About List Geofences (Legacy)

A geofence in Esper defines a geographic boundary — specified by latitude, longitude, and a radius — that triggers device actions (such as lockdown or beep) when a device crosses it. This endpoint belongs to the original standalone geofence API, which has been superseded by geofence configuration within blueprints. New integrations should use /api/v2/blueprints/ rather than this legacy path.

Security

esper_cloud_api_apiKey

Path

enterprise_idstring, (uuid)required

A UUID string identifying the enterprise.

Query

searchstring

A search term.

limitinteger

Number of results to return per page.

offsetinteger

The initial index from which to return the results.

cURL

curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v0/enterprise/{enterprise_id}/geofence/?search=string&limit=0&offset=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

successful operation

Bodyapplication/json

countintegerrequired

nextstring or null, (url)

previousstring or null, (url)

resultsArray of objects(esper_cloud_api_Geofence)required

Response

{
  "count": 0,
  "next": "string",
  "previous": "string",
  "results": [
    { … }
  ]
}