---
title: "List Events"
method: GET
path: "/network-troubleshooting/v1/events"
tags: ["Events"]
---

# List Events

`GET /network-troubleshooting/v1/events`

This API endpoint retrieves a list of Network Events, based on the query parameters provided. Each Event in the returned list includes details like event name, category, source type, severity, etc. The query parameters allow you to narrow down the results that meet specific criteria, ensuring you receive only the relevant data.

## Query parameters

- `context-type` 'SITE' | 'ACCESS_POINT' | 'SWITCH' | 'GATEWAY' | 'WIRELESS_CLIENT' | 'WIRED_CLIENT' | 'BRIDGE', required
- `context-identifier` string, required
- `start-at` string, date-time, required — Date-time in RFC 3339 format (ISO 8601) in UTC timezone with milliseconds.
- `end-at` string, date-time, required — Date-time in RFC 3339 format (ISO 8601) in UTC timezone with milliseconds.
- `site-id` string, required
- `search` string
- `filter` string
- `sort` string
- `next` string — Specifies the pagination cursor for the next page of resources.
- `limit` integer, required

## Response `200`

Response schema for listing events

- EventList — List of network events with pagination information.
  - `events` Event[], required — Array of network events
    - `eventId` string, required — The event type identifier
    - `eventIdentifier` string, required — Unique identifier for the event.
    - `serialNumber` string — Device serial number
    - `timeAt` string, date-time, required — Timestamp when the event occurred at the source, in RFC 3339 format with milliseconds.
    - `eventName` string, required — Name of the event.
    - `category` string, required — Event category.
    - `sourceType` 'Access Point' | 'Switch' | 'Gateway' | 'Wireless Client' | 'Wired Client' | 'Bridge', required — Type of source that generated the event.
    - `sourceName` string, required — Name of the device or client that generated the event.
    - `description` string, required — Detailed description of the event.
    - `clientMacAddress` string — MAC address of the client involved in the event.
    - `deviceMacAddress` string — MAC address of the device that generated the event.
    - `stackId` string — Stack identifier for stack-capable devices.
    - `bssid` string — Basic Service Set Identifier for wireless events.
    - `reason` string, required — Reason or cause of the event.
    - `severity` 'positive' | 'negative' | 'neutral', required — Severity level of the event.
  - `count` integer, required — Number of events in current response.
  - `total` integer, required — Total number of events matching the query criteria.
  - `next` string — Specifies the pagination cursor for the next page of resources.

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