List Destinations

Lists all destinations configured for your account. Results are paginated.

GET /destinations

This endpoint retrieves all event destinations configured for your Stedi account. You can filter the results by destination status or event type.

Each destination in the response includes summary information such as the destination name, URL, subscribed event types, status, and the last delivery time. To retrieve full details for a specific destination, use the Retrieve Destination endpoint.

Authorizations

Authorization · Required Header

A Stedi API Key for authentication. Supports both test and production API keys.

Query Parameters

pageSize · Number Range : ≥ 1 and ≤ 100

Number of items to return per page.

pageToken · String Length : 1 - 1024

The nextPageToken value from a previous response. You can use this to get the next page of results. If not set, Stedi returns the first page of results.

status · String

The destination's current status. Stedi only sends event payloads to ENABLED destinations.

Possible values

ENABLED

DISABLED

eventType · String Length : 1 - 255

Filter results by event type. Visit event types for a complete list.

Response

application/json

items · Array of Objects Required

The list of destination summaries.

concurrencyLimit · items[].concurrencyLimit · Number Range : ≥ 1

The maximum number of concurrent deliveries for this destination. Contact Stedi to change your account limits.

createdAt · items[].createdAt · String Required Format : date-time

Creation timestamp for this destination.

description · items[].description · String Required Max length : 1024

A description of the destination's purpose, such as "Receives transaction enrollment task notifications."

destinationUrl · items[].destinationUrl · String Required Regex pattern : ^https://.+$

The URL where Stedi delivers payloads through HTTP POST.

eventTypes · items[].eventTypes · Array of Strings Required Min items : 1

The event types Stedi sends to this destination. Visit event types for a complete list.

id · items[].id · String Required Regex pattern : ^[a-z]{3,5}_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

The unique identifier for the destination.

lastDeliveryTime · items[].lastDeliveryTime · String Format : date-time

The timestamp for Stedi's most recent delivery attempt to this destination. Absent when Stedi hasn't yet attempted a delivery.

name · items[].name · String Required Length : 1 - 255

A human-readable name for the destination. Stedi displays this name in the portal.

status · items[].status · String Required

The destination's current status. Stedi only sends event payloads to ENABLED destinations.

Possible values

ENABLED

DISABLED

updatedAt · items[].updatedAt · String Required Format : date-time

Last update timestamp for this destination.

nextPageToken · String Length : 1 - 1024

Token that you can supply in subsequent requests to retrieve the next page of results. If not returned, there are no more results.

Request

curl --request GET \
  --url "https://events.us.stedi.com/2026-02-01/destinations" \
  --header "Authorization: <api_key>"

Response

{
  "items": [
    {
      "createdAt": "2026-02-01T12:00:00Z",
      "description": "Receives enrollment notifications",
      "destinationUrl": "https://example.com/webhooks",
      "eventTypes": [
        "enrollment.activated"
      ],
      "id": "dst_550e8400-e29b-41d4-a716-446655440000",
      "lastDeliveryTime": "2026-02-01T12:00:01Z",
      "name": "My Destination",
      "status": "ENABLED",
      "updatedAt": "2026-02-01T12:00:00Z"
    }
  ]
}