---
title: "List events"
method: GET
path: "/workspaces/{ws_id}/events"
tags: ["Event"]
---

# List events

`GET /workspaces/{ws_id}/events`

## Query parameters

- `page_no` integer
- `page_size` integer
- `limit` integer
- `sort` 'id.desc' | 'id.asc'
- `after` string
- `before` string
- `created_at` union
  - object
    - `gt` integer
    - `gte` integer
    - `lt` integer
    - `lte` integer
  - integer
- `event_type` string
- `unique_id` string
- `ingested_at` union
  - object
    - `gt` integer
    - `gte` integer
    - `lt` integer
    - `lte` integer
  - integer

## Response `200`

OK

- union
  - object
    - `total` integer — Total number of resources.
    - `data` object[] — List of resources
      - `id` string
      - `event_type` string, required
      - `data` object, required
      - `ingested_at` integer — The time the event was ingested
      - `unique_id` string, nullable — The unique id used to de-duplication
      - `created_at` integer
      - `updated_at` integer
  - object
    - `next` string, nullable — URI to next page when available.
    - `prev` string, nullable — URI to previous page when available.
    - `data` object[] — List of resources
      - `id` string
      - `event_type` string, required
      - `data` object, required
      - `ingested_at` integer — The time the event was ingested
      - `unique_id` string, nullable — The unique id used to de-duplication
      - `created_at` integer
      - `updated_at` integer

## Changes

- **2026-04-23** `615fab6a6d38` — 1 breaking, 3 warning, 11 info
  - added `subschema #1, subschema #2` to the response body `oneOf` list for the response status `200`
  - for the `query` request parameter `page_size`, the max was set to `1000.00`
  - for the `query` request parameter `page_no`, the min was set to `1.00`
  - for the `query` request parameter `page_size`, the min was set to `1.00`
  - …11 more
- **2025-09-23** `811560414694` — 1 info
  - added the optional property `allOf[subschema #2]/data/items/unique_id` to the response with the `200` status
- **2025-07-29** `232f34fd9749` — 4 info
  - the response optional property `allOf[subschema #2]/data/items/created_at` became read-only for the status `200`
  - the response optional property `allOf[subschema #2]/data/items/updated_at` became read-only for the status `200`
  - the response property `allOf[subschema #2]/data/items/data` became required for the status `200`
  - the response property `allOf[subschema #2]/data/items/event_type` became required for the status `200`
- **2024-10-06** `394b3a9521a1` — 1 info
  - added the optional property `allOf[subschema #2]/data/items/ingested_at` to the response with the `200` status
- **2024-09-06** `041875436163` — 2 info
  - added the new optional `query` request parameter `page_no`
  - added the new optional `query` request parameter `page_size`

[Full history](https://skmtc.dev/webhookx-io/apis/webhookx-admin-api/changes/workspaces/:ws_id/events/get.md)

---

[API](https://skmtc.dev/webhookx-io/apis/webhookx-admin-api.md) · [All operations](https://skmtc.dev/webhookx-io/apis/webhookx-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/webhookx-io/webhookx-admin-api/revisions/0afb563ce365/schema)