Retrieve Destination

Retrieves details for an existing event destination.

GET /destinations/{destinationId}

This endpoint retrieves the full details of a specific event destination, including its configuration and current status.

1. Call this endpoint with the destination's ID. Stedi returns this ID in the responses from the Create Destination and List Destinations endpoints.
2. The endpoint returns the destination details, including the destination name, URL, subscribed event types, status, and timestamps for creation and last update.

Authorizations

Authorization · Required Header

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

Path Parameters

destinationId · String 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. You can retrieve destination IDs with the List Destinations endpoint.

Response

application/json

concurrencyLimit · Number Range : ≥ 1

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

createdAt · String Required Format : date-time

Creation timestamp for this destination.

description · String Required Max length : 1024

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

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

The URL where Stedi delivers payloads through HTTP POST.

eventTypes · Array of Strings Required Min items : 1

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

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 · 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 · String Required Length : 1 - 255

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

status · String Required

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

Possible values

ENABLED

DISABLED

updatedAt · String Required Format : date-time

Last update timestamp for this destination.

Request

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

Response

{
  "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",
  "name": "My Destination",
  "status": "ENABLED",
  "updatedAt": "2026-02-01T12:00:00Z"
}