---
title: "Gets rules associated with a device"
method: GET
path: "/associations/v3/{trackingId}/rules"
tags: ["Associations"]
---

# Gets rules associated with a device

`GET /associations/v3/{trackingId}/rules`

Gets a list of rules associated with the device `trackingId`.

## Query parameters

- `pageToken` string
- `count` integer

## Response `200`

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

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

- object — Response body contains an array of rule objects, count indicating the number of returned rules, and pageToken if available. If no rules 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[]
    - `rule` union, required
      - object
        - `description` string — Rule description
        - `name` string — Rule name
        - `threshold` object, required — Detention event is triggered when the asset has been continuously stationary for longer than the threshold duration.
          - `durationS` integer, required — Duration in seconds
        - `type` 'detention', required — The rule type
      - object
        - `description` string — Rule description
        - `name` string — Rule name
        - `threshold` object, required — Dwelling event is triggered when the asset has been continuously inside a geofence for longer than the threshold duration.
          - `durationS` integer, required — Duration in seconds
        - `type` 'dwelling', required — The rule type
      - object
        - `description` string — Rule description
        - `name` string — Rule name
        - `threshold` object, required — Utilization event is triggered when the asset starts moving indicating that the asset is utilized, and also when the asset stops moving and has been stationary for longer than the threshold duration indicating that the asset is unutilized.
          - `durationS` integer, required — Duration in seconds
        - `type` 'utilization', required — The rule type
      - object
        - `description` string — Rule description
        - `name` string — Rule name
        - `type` 'online', required — The rule type
    - `ruleId` string, uuid, required — Must be a valid UUIDv4.

## 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` — Not Found The specified resource 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/versions/efa162f7023c/schema)