---
title: "Gets a single rule"
method: GET
path: "/rules/v4/{ruleId}"
tags: ["Rules"]
---

# Gets a single rule

`GET /rules/v4/{ruleId}`

Gets details of a single rule identified by the `ruleId`.

## Response `200`

Response body contains a single rule object.

- object
  - `rule` union, required
    - 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
      - `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
      - `geofenceId` string, uuid, required — Geofence ID
      - `name` string — Rule name
      - `threshold` object, required
        - `maxVolume` integer — A maximum volume of stock
        - `minVolume` integer — A minimum volume of stock
      - `type` 'stock', required — The rule type
    - object
      - `description` string — Rule description
      - `name` string — Rule name
      - `type` 'online', required — The rule type
    - object
      - `description` string — Rule description
      - `name` string — Rule name
      - `threshold` object, required
        - `after` integer — Allowed time deviation in seconds from the planned ETD/ETA in case the shipment is behind the schedule
        - `before` integer — Allowed time deviation in seconds from the planned ETD/ETA in case the shipment is ahead of schedule
      - `type` 'shipmentSchedule', 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` — No rules with the provided ruleId were 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)