---
title: "List all alerts"
method: GET
path: "/network-notifications/v1/alerts"
tags: ["Alerts"]
---

# List all alerts

`GET /network-notifications/v1/alerts`

This API endpoint retrieves the list of Alerts based on the query parameters provided. The alerts list includes details such as name, type, category, severity, status, etc. The query parameters allow you to filter results that meet specific criteria, ensuring you receive only relevant data.

## Query parameters

- `filter` string
- `sort` string, const
- `next` string
- `limit` integer

## Response `200`

List of alerts, along with alert details and associated pagination information.

- AlertListResponse
  - `items` Alert[] — List of alerts.
    - `id` string, required — Unique identifier for the alert.
    - `key` string, required — Alert key.
    - `category` string, required — Category of the alert.
    - `typeId` string, required — Type identifier of the alert.
    - `name` string, required — Name of the alert.
    - `severity` string, required — Severity level of the alert.
    - `priority` string, required — Priority level of the alert.
    - `status` string, required — Current status of the alert.
    - `summary` string, required — Summary description of the alert.
    - `createdAt` string, date-time, required — Timestamp when the alert was created.
    - `updatedAt` string, date-time, required — Timestamp when the alert was last updated.
    - `updatedBy` string, required — Identifier of the user who last updated the alert.
    - `type` string, required — Type of the resource.
    - `deviceType` string, required — Type of device associated with the alert.
    - `clearedReason` string, required — The reason an alert is cleared. This will be populated only when the status is cleared.
  - `count` integer — Number of alerts returned in the current response.
  - `total` integer — Total number of alerts matching the query criteria.
  - `next` string — Specifies the pagination cursor for the next page of resources. Null if there are no further pages.

## 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)