---
title: "List notification rules"
method: GET
path: "/v1/notifications"
---

# List notification rules

`GET /v1/notifications`

## Request

- Base URL: `https://statusstack.com/api`
- URL: `https://statusstack.com/api/v1/notifications`
- Auth: HTTP bearer

Notification rules on the API key's team and its organization (at most 100). For a
session-authenticated caller, the user's current team and its organization. Read-only:
rules are managed in the dashboard. A request that resolves to neither a team nor an
organization gets an empty list.

## Response `200`

The notification rules in scope.

- object
  - `data` object, required
    - `rules` NotificationRule[], required
      - `id` integer
      - `channel` string: Delivery channel, e.g. `email`, `slack`, `sms`, `webhook`.
      - `recipient` string, nullable: Address the channel delivers to (email address, phone number, URL).
      - `options` object: Which status events trigger the rule.
        - `alerts` boolean: Outages.
        - `warnings` boolean: Degradations.
        - `maintenance` boolean: Informational events such as maintenance.
        - `clear` boolean: Recovery back to operational.
      - `early_warning` object: Crowdsourced early-warning alerts, sent before the provider confirms an incident.
        - `enabled` boolean
        - `min_confidence` number, float: Minimum confidence (0–1) a crowdsourced incident needs to alert.
        - `min_reports` integer: Minimum number of user reports a crowdsourced incident needs to alert.
      - `disabled` boolean: True when the rule is switched off and sends nothing.
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable

## Other responses

- `401`: No bearer credentials, or credentials that do not resolve to an API key or Sanctum token. Produced by `ApiAuthentication` ahead of the route, so every operation in the v1 group can return it.
- `403`: The API key lacks the required permission, or a policy denied the action. The two come from different layers and return different bodies, so this is a union rather than one shape.
- `429`: The `v1-api` rate limit (120 requests per minute) was exceeded. Applies to every operation in the v1 group.

---

[API](https://skmtc.dev/statusstack/apis/statusstack-api.md) - [All operations](https://skmtc.dev/statusstack/apis/statusstack-api/llms.txt) - [OpenAPI document](https://skmtc.dev/statusstack/apis/statusstack-api/revisions/a5fabf6ac5e4?raw)