Returns aggregate device statistics for a specific geofence — total device count, how many devices are currently inside the boundary, and how many are outside. Use it for a quick, single-call summary rather than pulling the full device list.
Scoped to a single geofence_id and returns counts only, not individual device records — use the devices sub-resource for per-device detail.
About Geofences
A geofence is a virtual geographic boundary tied to device location tracking; devices are continuously evaluated as inside or outside the fence to trigger configured actions. This endpoint gives an at-a-glance rollup of that inside/outside state across all devices tied to the geofence.
Key Fields / Query Parameters
- geofence_id — path parameter identifying the geofence to summarize
Common Use Cases
- Powering a geofence dashboard tile showing total/inside/outside device counts
- Quickly checking compliance for a location-restricted fleet without listing every device
Security
geofence_bearerAuth
- Mock serverhttps://api.esper.io/_mock/openapi/geofence/v1/geofences/{geofence_id}/device-summary
- https://develop-api.esper.cloud/apihttps://develop-api.esper.cloud/api/geofence/v1/geofences/{geofence_id}/device-summary
curl -i -X GET \
https://api.esper.io/_mock/openapi/geofence/v1/geofences/f5316a75-f186-4769-970e-28d6a1a0e110/device-summary \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'X-Caller-Id: string' \
-H 'X-Esper-Tenant-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08'Response
{ "content": { "total_devices": 100, "inside_count": 60, "outside_count": 35, "unknown_count": 5 } }