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

# List Events

`GET /events`

List events with optional filters.

## Query parameters

- `event_type` string[], nullable
- `severity` EventSeverity[], nullable
- `requires_action` boolean, nullable
- `acknowledged` boolean, nullable
- `from` string, date-time, nullable
- `to` string, date-time, nullable
- `trace_id` string, nullable
- `actor_id` string, nullable
- `actor_type` string, nullable
- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- EventListResponse — Paginated list of events.
  - `data` EventResponse[], required
    - `_links` EventLinks, required — HAL-style links for an event.
      - `action` string, nullable
      - `execution` string, nullable
      - `job` string, nullable
      - `self` string, required
    - `acknowledged` boolean, required
    - `acknowledged_at` string, date-time, nullable
    - `acknowledged_by` string, nullable
    - `actor_id` string, nullable
    - `actor_type` string, nullable
    - `created_at` string, date-time, required
    - `data` object
    - `detail` string, nullable
    - `event_id` string, required
    - `requires_action` boolean, required
    - `severity` 'info' | 'warning' | 'error' | 'critical', required — Severity level for platform events.
    - `summary` string, required
    - `trace_id` string, nullable
    - `type` string, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/jentic/apis/jentic-control-plane-api.md) · [All operations](https://skmtc.net/jentic/apis/jentic-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jentic/jentic-control-plane-api/revisions/4ccade8cfa18/schema)