Get blueprint usage statistics for a geofence
Returns paginated statistics on blueprint usage within a specific geofence — which blueprints are applied to devices inside that geofence and how many devices use each. Use it to understand how blueprint-driven configuration correlates with a location-based boundary.
Scoped to a single geofence_id; each result identifies a blueprint and the count of devices in that geofence currently using it.
About Geofences
A geofence is a virtual geographic boundary that can be tied to blueprint-based device configuration, so devices entering or leaving the boundary can be managed differently depending on which blueprint they're running. This endpoint gives visibility into that blueprint-to-geofence relationship.
Key Fields / Query Parameters
- geofence_id — path parameter identifying the geofence to report on
Common Use Cases
- Auditing which blueprint versions are in use across devices within a specific geofence
- Verifying blueprint rollout coverage for a location-restricted device population
Request
- Base URLhttps://develop-api.esper.cloud/api
- URLhttps://develop-api.esper.cloud/api/geofence/v1/geofences/{geofence_id}/blueprints
- AuthHTTP bearer
Path parameters
UUID of the geofence
Query parameters
Number of items to skip before starting to collect the result set
Maximum number of items to return
Headers
Esper tenant ID associated with the request
Unique identifier for the caller
Response
Blueprint usage statistics retrieved successfully
Example response
{
"content": {
"next": "/v1/geofences/f5316a75-f186-4769-970e-28d6a1a0e110/blueprints?offset=10&limit=10",
"results": [
{
"blueprint_id": "550e8400-e29b-41d4-a716-446655440000",
"blueprint_version_number": 1,
"device_count": 25
}
]
}
}Changes
No recorded changes to this operation across all 6 revisions of this API.