---
title: "List alert configurations"
method: GET
path: "/network-notifications/v1/alert-config"
tags: ["Alert Configurations"]
---

# List alert configurations

`GET /network-notifications/v1/alert-config`

Retrieves alert configurations for a given scope. Each configuration defines the threshold rules, severity mappings, and settings for a specific alert type. Configurations may be locally defined or inherited from a parent scope.

**Scope types:**

| Value | Description |
|-------|-------------|
| `GLOBAL` | Tenant-level scope (default) |
| `SITE` | Site-level scope |
| `DEVICE` | Device-level scope |

**Pagination:**

Use `limit` and `next` together to page through large result sets. When `limit` is supplied the response includes `total` (total available configurations) and `offset` (zero-based index of the first item returned), enabling clients to determine whether additional pages exist.

## Query parameters

- `scope-id` string, required
- `scope-type` 'GLOBAL' | 'SITE' | 'DEVICE'
- `limit` integer
- `next` integer

## Response `200`

List of alert configurations for the requested scope.

- object — Paginated list of alert configurations.
  - `id` string, required — Unique identifier for this collection resource.
  - `type` string, required — Resource type identifier.
  - `items` AlertConfigResponse[], required — List of alert configuration entries in the current page.
    - `name` string — Human-readable name of the alert type.
    - `description` string — Description of what the alert monitors.
    - `label` string — Display label or tag for the alert configuration.
    - `category` string — Category the alert belongs to.
    - `deviceType` string — Type of device this alert applies to.
    - `enabled` boolean — Indicates whether this alert configuration is currently active or not.
    - `ruleSource` 'SYSTEM' | 'USER' — Indicates whether the rule is system-defined or user-defined.
    - `clearTimeout` string — Auto-clear timeout duration, e.g. `1H`, `30D`.
    - `inherited` boolean — Indicates whether this configuration is inherited from a parent scope or not.
    - `scopeId` string — The scope identifier this configuration belongs to.
    - `scopeType` 'GLOBAL' | 'SITE' | 'DEVICE' — The scope type this configuration belongs to.
    - `rules` AlertConfigRuleResponse[] — List of threshold rules for this alert configuration.
      - `ruleNumber` integer — Ordering index of this rule.
      - `rule` object — Rule details.
        - `duration` integer — Observation window in minutes.
        - `condition` object[] — List of severity-to-threshold conditions.
          - `severity` string — Severity level for this condition.
          - `expression` object
            - `metric` string
            - `operator` string
            - `valueNumber` number
        - `additionalCondition` object[] — List of supplementary metric conditions.
          - `index` integer
          - `expression` object
            - `metric` string
            - `operator` string
            - `valueNumber` number
  - `count` integer, required — Number of alert configurations returned in the current page.
  - `total` integer — Total number of alert configurations available across all pages. Present only when the request includes a `limit` parameter.
  - `offset` integer — Zero-based index of the first item returned in this page. Present only when the request includes a `limit` parameter.

## Other responses

- `400` — Invalid input received.
- `401` — Unauthorized. Authentication credentials are required or invalid.
- `403` — Forbidden: Access is denied.
- `404` — Not Found error.
- `429` — Too Many Requests. The user has sent too many requests in a given amount of time.
- `500` — Internal Server Error. An unexpected error occurred on the server.

---

[API](https://skmtc.net/arubanetworks/apis/authorization.md) · [All operations](https://skmtc.net/arubanetworks/apis/authorization/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arubanetworks/authorization/revisions/74c95058b11f/schema)