geofence_Device State

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
get/geofence/v1/geofences/{geofence_id}/blueprints

Request

  • Base URL
    https://develop-api.esper.cloud/api
  • URL
    https://develop-api.esper.cloud/api/geofence/v1/geofences/{geofence_id}/blueprints
  • Auth
    HTTP bearer

Path parameters

geofence_idstring uuid required

UUID of the geofence

Query parameters

offsetinteger

Number of items to skip before starting to collect the result set

limitinteger

Maximum number of items to return

Headers

X-Esper-Tenant-Idstring uuid required

Esper tenant ID associated with the request

X-Caller-Idstring required

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.