---
title: "Gets all devices associated with a sensor rule"
method: GET
path: "/associations/v3/sensors/{sensorRuleId}"
tags: ["Associations"]
---

# Gets all devices associated with a sensor rule

`GET /associations/v3/sensors/{sensorRuleId}`

Gets all devices associated with the sensor rule `sensorRuleId`.

## Query parameters

- `pageToken` string
- `count` integer

## Response `200`

Response body contains an array of device objects, count indicating the number of returned devices,
and pageToken if available.

If no associations are found, an object with empty data array is returned.

- object — Response body contains an array of device objects, count indicating the number of returned devices, and pageToken if available. If no devices are found, an object with empty data array is returned.
  - `count` integer — The number of items in the response.
  - `pageToken` string — A token that can be used to retrieve the next page of the response.
  - `data` object[]
    - `appId` string — Virtual device application ID, only present when the device is virtual
    - `externalId` string — Virtual device external ID, only present when the device is virtual
    - `trackingId` string, 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`.

## Other responses

- `400` — Bad request The request object is in an incorrect format or has values that are invalid or out of range. If available, further error details are provided in the response body.
- `401` — Unauthorized The request did not provide correct authentication details
- `403` — Forbidden The account does not have the correct privileges
- `404` — The sensor rule ID was not found

---

[API](https://skmtc.net/here/apis/tracking.md) · [All operations](https://skmtc.net/here/apis/tracking/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/here/tracking/revisions/efa162f7023c/schema)