---
title: "list a page of events."
method: GET
path: "/events/page"
tags: ["events"]
---

# list a page of events.

`GET /events/page`

## Request

- Base URL: `/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/events/page`
- Auth: none declared

Returns a paginated event object. Page is one-based and required, with 12 rows by default and a maximum of 1000. Repeated namespace/name/kind/object_id values are ORed within each field; fields and inclusive time bounds are ANDed.
Time bounds accept RFC3339 timestamps. Comparison precision depends on the database. Sort ties use ID in the same direction. next_page is null when there are no more events. include_total=true additionally returns total and total_pages, with total_pages=0 for no matches. Count and page can change under concurrent writes; separate requests are not a fixed snapshot.

## Query parameters

- `created_at` string
- `name` string[]
- `namespace` string[]
- `object_id` string[]
- `kind` string[]
- `start` string
- `end` string
- `page` integer, required
- `limit` integer
- `include_total` boolean
- `sort` 'id' | 'object_id' | 'namespace' | 'name' | 'kind' | 'created_at' | 'message'
- `order` 'asc' | 'desc'

## Response `200`

OK

- EventPageResponse
  - `events` GithubComChaosMeshChaosMeshPkgDashboardCoreEvent[], required
    - `created_at` string
    - `id` integer
    - `kind` string
    - `message` string
    - `name` string
    - `namespace` string
    - `object_id` string
    - `reason` string
    - `type` string
  - `limit` integer, required
  - `next_page` integer, nullable, required
  - `page` integer, required
  - `total` integer
  - `total_pages` integer

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

## Changes

- **2026-11-12** `c6f1f3fded48`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/chaos-mesh/apis/chaos-mesh-dashboard-api/changes/events/page/get.md)

---

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