Skip to content

Get geofence information
Stable

Request

Returns geofence instance

Security
apiKey
Path
geofence_idstring, (uuid)required

A UUID string identifying the geofence.

enterprise_idstring, (uuid)required

A UUID string identifying the enterprise.

cURL
curl -i -X GET \
  'https://develop-api.esper.io/_mock/openapi/v0/enterprise/{enterprise_id}/create-apply-geofence/{geofence_id}/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

successful operation

Bodyapplication/json
idstring, (uuid)(Geofence id)read-only

id of the geofence

namestring(Geofence name)required

Name of the geofence

descriptionstring(Geofence description)

A description about the geofence

enterprisestring, (uuid)(Enterprise id)read-only

id of the enterprise resource

latitudestring, (decimal)(Geofence latitude)required

Latitude corresponding to the geofence

longitudestring, (decimal)(Geofence longitude)required

Longitude corresponding to the geofence

radiusinteger(Geofence radius)

The radius within which the geofence should be applied

radius_unitstring(Unit of radius)

The unit in which the radius is taken, eg - kilometers, meters etc

Enum:"KILOMETERS""METERS""MILES"
device_actionsArray of strings(Device Actions)

The actions to be performed on the device

Items Enum:"LOCK_DOWN""BEEP"
device_countinteger(Device count)read-only

Number of devices

created_bystring(Created by)read-only

The user who created the geofence

created_onstring, (date-time)(Creation date and time)read-only

Date and time of when the geofence was created

updated_onstring, (date-time)(Updation date and time)read-only

Date and time of when the geofence was updated

Response
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "description": "string",
  "enterprise": "796caaf9-a7de-4817-9ffa-39d04bf83de9",
  "latitude": "string",
  "longitude": "string",
  "radius": 0,
  "radius_unit": "KILOMETERS",
  "device_actions": [
    "LOCK_DOWN"
  ],
  "device_count": 0,
  "created_by": "string",
  "created_on": "2019-08-24T14:15:22Z",
  "updated_on": "2019-08-24T14:15:22Z"
}