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

# List Events

`GET /events`

Retrieves a list of events.

When authenticated with a Tenant JWT, returns only events belonging to that tenant.
When authenticated with Admin API Key, returns events across all tenants. Use `tenant_id` query parameter to filter by tenant.

## Query parameters

- `id` union
  - string
  - string[]
- `tenant_id` union
  - string
  - string[]
- `destination_id` union
  - string
  - string[]
- `topic` union
  - string
  - string[]
- `time` Operator — Comparison operators for filtering by date-time values (RFC3339 or YYYY-MM-DD format).
  - `gte` string, date-time — Filter with value >= the specified date-time.
  - `lte` string, date-time — Filter with value <= the specified date-time.
  - `gt` string, date-time — Filter with value > the specified date-time.
  - `lt` string, date-time — Filter with value < the specified date-time.
- `limit` integer
- `next` string
- `prev` string
- `order_by` 'time'
- `dir` 'asc' | 'desc'

## Response `200`

A paginated list of events.

- EventPaginatedResult — Paginated list of events.
  - `pagination` SeekPagination — Cursor-based pagination metadata for list responses.
    - `order_by` string — The field being sorted on.
    - `dir` 'asc' | 'desc' — Sort direction.
    - `limit` integer — Page size limit.
    - `next` string, nullable — Cursor for the next page of results. Null if no more results.
    - `prev` string, nullable — Cursor for the previous page of results. Null if on first page.
  - `models` Event[] — Array of event objects.
    - `id` string
    - `tenant_id` string — The tenant this event belongs to.
    - `matched_destination_ids` string[] — The destination IDs that this event was routed to based on topic and filter matching.
    - `topic` string
    - `time` string, date-time — Time the event was received/processed.
    - `metadata` object, nullable — Key-value string pairs of metadata associated with the event.
    - `data` object — Freeform JSON data of the event.

## Other responses

- `401` — Missing or invalid authentication credentials.
- `500` — Unexpected server error.

## Changes

- **2026-04-29** `bcb9e555f8f3` — 4 warning, 1 info
  - deleted the `query` request parameter `time[gt]`
  - deleted the `query` request parameter `time[gte]`
  - deleted the `query` request parameter `time[lt]`
  - deleted the `query` request parameter `time[lte]`
  - …1 more
- **2026-04-01** `fc0f1ed2f42d` — 1 warning, 2 info
  - removed the optional property `models/items/destination_id` from the response with the `200` status
  - added the new optional `query` request parameter `destination_id`
  - added the optional property `models/items/matched_destination_ids` to the response with the `200` status
- **2026-03-10** `17794eb6e26d` — 5 info
  - added the new optional `query` request parameter `id`
  - added the new optional `query` request parameter `time[gt]`
  - added the new optional `query` request parameter `time[lt]`
  - `query` request parameter `tenant_id` list-of-types was widened by adding types `array`
  - …1 more
- **2026-02-20** `c36d2dacd201` — 1 warning, 5 info
  - removed the optional property `models/items/successful_at` from the response with the `200` status
  - the endpoint scheme security `AdminApiKey` was added to the API
  - the endpoint scheme security `TenantJwt` was added to the API
  - added the media type `application/json` for the response with the status `401`
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/hookdeck/apis/outpost-api/changes/events/get.md)

---

[API](https://skmtc.dev/hookdeck/apis/outpost-api.md) · [All operations](https://skmtc.dev/hookdeck/apis/outpost-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hookdeck/outpost-api/revisions/506c7bcee34b/schema)