---
title: "Search for alert rules."
method: GET
path: "/v2/rule"
tags: ["Alert"]
---

# Search for alert rules.

`GET /v2/rule`

Search and list configured alert rules by freetext filter to discover rule IDs for use in alert queries.

## Query parameters

- `freetext` string
- `limit` integer
- `taggedText` boolean

## Response `200`

output

- AlertRuleSearchResponseV2 — Paginated list of alerting rule configurations.
  - `data` object, required
    - `results` object[], required — Array of alerting rule objects.
      - `id` string — Rule identifier
      - `title` string — Human-readable rule name
      - `priority` boolean — Whether this is a high-priority rule
      - `enabled` boolean — Whether this rule is actively generating alerts
      - `created` string, date-time — ISO 8601 creation timestamp
      - `owner` object — Organization that owns this rule.
        - `name` string — Organization name
        - `id` string — Organization user hash ID
      - `intelligence_goals` object[] — Linked intelligence goals.
        - `name` string — Intelligence goal name
        - `id` string — Intelligence goal ID
      - `use_case_id` string, nullable — Associated use case identifier, or null
      - `tags` string[] — Tags applied to this rule.
      - `notification_settings` object — Notification configuration for this rule.
        - `email_subscribers` object[] — Users receiving email notifications.
          - `name` string
          - `id` string
        - `mobile_subscribers` object[] — Users receiving mobile notifications.
          - `name` string
          - `id` string
  - `counts` Counts, required — Pagination counts for list responses.
    - `returned` number, required
    - `total` number, required

---

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