---
title: "List Rules"
method: GET
path: "/api/v1/alerts/rules"
tags: ["ALERTS_V1"]
---

# List Rules

`GET /api/v1/alerts/rules`

Paginated list of alert/report rules.

## Query parameters

- `rule_type` string, nullable — 'alert' or 'report'
- `platform` string, nullable — 'snowflake' or 'databricks'
- `status` string, nullable
- `category` string, nullable
- `search` string, nullable
- `page` integer — Page number
- `size` integer — Page size

## Response `200`

Successful Response

- PageRuleResponse
  - `items` RuleResponse[], required
    - `id` integer, required
    - `name` string, required
    - `description` string, nullable
    - `rule_type` string, required
    - `platform` string, required
    - `category` string, nullable
    - `entity_type` string, required
    - `metric_config` MetricConfig, required — Typed representation of the metric_config JSON stored in alert rules.
      - `metric_name` string, required — Metric identifier, e.g. 'warehouse_daily_cost'
      - `params` MetricParams — Evaluation parameters within a metric config.
        - `comparison_type` string — 'absolute_value' or 'relative_value'
        - `threshold_type` string — 'exceeds', 'below', 'changes_by', or 'changes_by_percent'
        - `threshold_value` number — Threshold to compare against
        - `aggregation` string — 'sum', 'mean', 'max', or 'min'
        - `date_range` string — 'previous_day', 'previous_week', 'previous_month', or 'previous_year'
        - `is_percentage` boolean, nullable — Derived from threshold_type; included by templates
      - `filters` MetricFilter[]
        - `key` string, required — Filter dimension name, e.g. 'warehouse'
        - `value` string[] — Filter values, e.g. ['WH1', 'WH2'], ['all'], or ['ANY']
        - `order` integer — Display order of this filter
      - `category` string, nullable — Entity type echo; included by templates
    - `delivery` object, nullable
    - `alert_message` string, nullable
    - `status` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `created_by` integer, required
    - `last_run` RunResponse
      - `id` integer, required
      - `rule_id` integer, required
      - `status` string, required
      - `result` object, nullable
      - `error` object, nullable
      - `message` string, nullable
      - `executed_at` string, date-time, nullable
      - `created_at` string, date-time, required
    - `recent_runs` RecentRunResponse[]
      - `id` integer, required
      - `status` string, required
      - `executed_at` string, date-time, nullable
      - `message` string, nullable
    - `summary` string, nullable
  - `total` integer, nullable, required
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/versions/aab3fe5c9f05/schema)