Events

List an event destination's events

Changed on Sep 18, 2026

Returns a cursor-paginated list of the events fanned out to this destination, newest first, with the destination's per-event delivery outcome. Filter by delivery_status and fire time (created[gte] / created[lte]), and expand attempts to include each delivery try. Events remain inspectable after the destination is deleted.

get/event-destinations/{event_destination}/events

Request

Base URL: https://api.ekho.com
URL: https://api.ekho.com/event-destinations/{event_destination}/events
Auth: HTTP bearer

Path parameters

event_destinationstring required

Example:whe_a1b2c3d4e5f6

Query parameters

limitinteger

Page size, 1 to 100.

Example:20

starting_afterstring

Return the page after this resource id (newest first).

delivery_status'pending' | 'delivered' | 'failed'

Filter to a single per-destination delivery status.

created[gte]integer

Only events fired at or after this epoch ms.

Example:1767225600000

created[lte]integer

Only events fired at or before this epoch ms.

Example:1767225600000

expand[]string[]

Repeatable. Expand attempts to include each delivery try.

Response

A page of events for the destination.

has_moreboolean required

True when another page follows the returned one.

next_cursorstring nullable required

Pass as starting_after to fetch the next page; null when has_more is false.

Example response

{
  "data": [
    {
      "id": "evt_7Ye2kQp91LmXw4Za",
      "attempts": [
        {
          "id": "atmpt_Zw8n1Rq4Yv5c",
          "event_id": "evt_7Ye2kQp91LmXw4Za"
        }
      ]
    }
  ]
}

Changes

Sep 18, 202678c545d96a34 Revision changes
- warning
  added the new external_id_in_use enum value to the response property for the response status
- warning
  added the new external_id_in_use enum value to the response property for the response status
- warning
  added the new external_id_in_use enum value to the response property for the response status
- warning
  added the new external_id_in_use enum value to the response property for the response status
- warning
  added the new external_id_in_use enum value to the response property for the response status
- warning
  added the new external_id_in_use enum value to the response property for the response status
- warning
  added the new requires_ekho_review enum value to the response property for the response status
- warning
  added the new requires_ekho_review enum value to the response property for the response status
- warning
  added the new requires_ekho_review enum value to the response property for the response status
- warning
  added the new requires_ekho_review enum value to the response property for the response status
- warning
  added the new requires_ekho_review enum value to the response property for the response status
- warning
  added the new requires_ekho_review enum value to the response property for the response status
- warning
  added the new resource_not_writable enum value to the response property for the response status
- warning
  added the new resource_not_writable enum value to the response property for the response status
- warning
  added the new resource_not_writable enum value to the response property for the response status
- warning
  added the new resource_not_writable enum value to the response property for the response status
- warning
  added the new resource_not_writable enum value to the response property for the response status
- warning
  added the new resource_not_writable enum value to the response property for the response status

Operation history