efa162f7023c

latestOpenAPI 3.0.0HERE Documentation License2026-07-142162791.8 MB
Device Associations

Gets geofences associated with a device

Gets all geofences associated with the device with trackingId.

get/device-associations/v2/{trackingId}/geofences

Path parameters

trackingIdstring required

This is a unique ID associated with the device data in HERE Tracking. For physical devices the trackingId gets assigned to a device when the device is claimed by a user, and for virtual devices it is an external device ID along with the device project appId.

Query parameters

pageTokenstring

A token from the previously returned response to retrieve the specified page.

countinteger

The number of items to return per page.

appIdstring

Application identifier. Used together with an external ID to identify a virtual device.

Headers

X-Request-Idstring uuid

ID used for correlating requests within HERE Tracking. Used for logging and error reporting.

Must be a valid UUIDv4.

Response

Response body contains an array of geofence objects, count specifies the number of returned geofences, and pageToken indicates the next available page in the matching result set.

If no geofences are found, an object with empty data array is returned. Response content type can be either JSON or protobuf depending on the 'Content-Type' request header.

countinteger

The number of items in the response.

pageTokenstring

A token that can be used to retrieve the next page of the response.