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

# List Operator Events

`GET /operator-events/events`

## Request

- Base URL: `https://api.outpost.hookdeck.com/2025-07-01`
- URL: `https://api.outpost.hookdeck.com/2025-07-01/operator-events/events`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns the 100 most recent operator events emitted by this deployment, newest first.
Paging is not available yet: this operation takes no query parameters, so
`pagination.next` cannot be passed back.

Each row is an Outpost event whose `topic` is the operator event topic, whose
`matched_destination_ids` are operator event destinations, and whose `tenant_id` is the
ID of your Outpost project. The topic-specific payload is nested under `data`, which
carries the same envelope the sink receives: `id`, `topic`, `time`, `tenant_id` and a
`data` object described on the
[Operator Events](https://hookdeck.com/docs/outpost/features/operator-events) feature page.

This endpoint is only available on managed Outpost.

## Response `200`

A paginated list of operator 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.
    - `eligible_for_retry` boolean: Whether this event can be retried.
    - `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-10-02** `a4ddd5c7a824`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hookdeck/apis/outpost-api/changes/operator-events/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.dev/hookdeck/apis/outpost-api/revisions/10262afe0dba?raw)