---
title: "Gets all alert rules for the authenticated account."
method: GET
path: "/alerts/rules"
tags: ["Alerts"]
---

# Gets all alert rules for the authenticated account.

`GET /alerts/rules`

An alert rule defines the conditions that raise alerts for one or more devices.
Results are scoped to the account associated with the API key and can be narrowed,
paginated, and filtered using the query parameters below.
Requires the `AlertRules_View` securable.

## Query parameters

- `id` string
- `org_id` string
- `take` integer
- `page` integer

## Response `200`

The list of alert rules (may be empty).

- AlertRule[]
  - `id` string, nullable — The alert rule id (encrypted)
  - `name` string, nullable — The name of the alert rule
  - `rule_set` string, nullable — The rule set configuration as a JSON string. See AlertRuleInput.ruleSet for the full schema, supported condition types, operators, and value semantics.
  - `is_enabled` boolean, nullable — Indicates whether the alert rule is currently enabled and will be evaluated. When false, the rule is stored but never triggers alerts.
  - `period` integer, nullable — The look-back / evaluation period, in minutes, used by time-window based conditions.
  - `threshold` integer, nullable — A legacy scalar threshold value retained for backward compatibility. Thresholds for new rules are expressed inside the rule set (AlertRuleInput.ruleSet) via each item's "value" instead.
  - `webhook_url` string, nullable — Optional HTTPS webhook URL that is invoked (HTTP POST) when the rule triggers.
  - `all_devices` boolean, nullable — When true, the rule is evaluated against every device in the account and RevelDigital.Core.PublicApi.Models.AlertRule.DeviceIds is empty. When false, only RevelDigital.Core.PublicApi.Models.AlertRule.DeviceIds are evaluated.
  - `all_users` boolean, nullable — When true, all users in the account are notified and RevelDigital.Core.PublicApi.Models.AlertRule.UserIds is empty. When false, only the users in RevelDigital.Core.PublicApi.Models.AlertRule.UserIds are notified.
  - `created_on` string, date-time, nullable — The date and time the alert rule was created
  - `updated_on` string, date-time, nullable — The date and time the alert rule was last updated
  - `device_ids` string[], nullable — The devices explicitly associated with the rule (encrypted ids). Empty when RevelDigital.Core.PublicApi.Models.AlertRule.AllDevices is true.
  - `user_ids` string[], nullable — The users explicitly notified by the rule (encrypted ids). Empty when RevelDigital.Core.PublicApi.Models.AlertRule.AllUsers is true.

## Other responses

- `401` — The API key is missing or invalid.
- `403` — The caller lacks the AlertRules_View securable.

---

[API](https://skmtc.net/reveldigital/apis/revel-digital-rest-api.md) · [All operations](https://skmtc.net/reveldigital/apis/revel-digital-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reveldigital/revel-digital-rest-api/versions/f23a94aea621/schema)