Events

List events

Changed on

Returns a cursor-paginated list of the events recorded for your account, newest first, with each event delivery state across every target. Filter by status, event_type, and fire time (created[gte] / created[lte]). Unlike the per-destination events feed this is scoped to the account, so it also lists events for an account that owns no event destination. Event bodies are not returned.

get/events

Request

  • Base URL: https://api.ekho.com
  • URL: https://api.ekho.com/events
  • Auth: HTTP bearer

Query parameters

limitinteger

Page size, 1 to 100.

Example:20
starting_afterstring

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

status'no_subscribers' | 'pending' | 'delivered' | 'partial' | 'failed'

Filter to a single delivery state, e.g. failed.

event_type'preorder.placed' | 'preorder.updated' | 'lead.created' | 'lead.updated' | 'order.vehicle.placed' | 'order.vehicle.updated' | 'inventory.created' | 'inventory.updated'

Filter to a single event type.

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

Response

A page of events for the account.

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"
    }
  ]
}

Changes

  • 78c545d96a34Revision 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 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

  • 2a0b497bcf22Revision changes
    • warning

      added the new inventory.created enum value to the // response property for the response status

    • warning

      added the new inventory.updated enum value to the // response property for the response status

    • info

      added the new enum value inventory.created to the query request parameter event_type

    • info

      added the new enum value inventory.updated to the query request parameter event_type