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

# List event destinations

`GET /event-destinations`

Returns a cursor-paginated list of the account's event destinations, newest first. Filter by `status`, or by `event_type` to return every destination whose `event_types` include that one. Deleted destinations are excluded.

## Query parameters

- `limit` integer — Page size, 1 to 100.
- `starting_after` string — Return the page after this resource id (newest first).
- `status` 'enabled' | 'disabled' | 'auto_disabled' — Filter to a single destination status.
- `event_type` 'preorder.placed' | 'preorder.updated' | 'lead.created' | 'lead.updated' | 'order.vehicle.placed' | 'order.vehicle.updated' — Filter to destinations whose `event_types` include this one.

## Response `200`

A page of event destinations.

- object
  - `data` EventDestination[], required
    - `id` string, required — Typed event destination id; ids carry the `whe_` prefix.
    - `url` string, required
    - `event_types` string[], required — Every event type this destination receives.
    - `status` 'enabled' | 'disabled' | 'auto_disabled', required
    - `display_name` string, nullable, required
    - `description` string, nullable, required
    - `environment` 'dev' | 'test' | 'demo' | 'live', required — Token environment the destination was created under.
    - `api_version` string, required — API version pinned at creation.
    - `secret` string, nullable, required — The signing secret, returned only by create and rotate-secret. Store it on receipt; it is never shown again.
    - `created_at` integer, required — Epoch milliseconds the destination was created.
  - `has_more` boolean, required — True when another page follows the returned one.
  - `next_cursor` string, nullable, required — Pass as `starting_after` to fetch the next page; null when `has_more` is false.

## Other responses

- `400` — The request was malformed or failed validation.
- `401` — Authentication is missing or invalid.
- `403` — The token lacks a required scope.
- `429` — The rate limit has been exceeded.
- `500` — An unexpected error occurred.

---

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