Retrieve an event destination

curl --request GET \
  --url https://api.deck.co/v2/event-destinations/{destination_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.deck.co/v2/event-destinations/{destination_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.deck.co/v2/event-destinations/{destination_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.deck.co/v2/event-destinations/{destination_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.deck.co/v2/event-destinations/{destination_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "evtd_AbC123xYz456",
  "object": "<string>",
  "name": "<string>",
  "status": "<string>",
  "type": "webhook",
  "events": [
    "<string>"
  ],
  "created_at": "2026-08-24T12:00:00Z",
  "updated_at": "2026-08-24T12:00:00Z",
  "filter": {},
  "request_id": "<string>",
  "test_endpoint": {
    "inspect_url": "<string>"
  },
  "webhook": {
    "url": "<string>"
  },
  "aws_sqs": {
    "queue_url": "<string>"
  },
  "aws_kinesis": {
    "stream_name": "<string>",
    "region": "<string>"
  },
  "aws_s3": {
    "bucket": "<string>",
    "region": "<string>"
  },
  "aws_eventbridge": {
    "region": "<string>",
    "event_bus_name": "<string>"
  },
  "gcp_pubsub": {
    "project_id": "<string>",
    "topic": "<string>"
  },
  "rabbitmq": {
    "exchange": "<string>",
    "server_url": "<string>"
  },
  "azure_servicebus": {
    "name": "<string>"
  },
  "hookdeck": {},
  "cloudflare_queues": {
    "account_id": "<string>",
    "queue_id": "<string>"
  }
}

{
  "errors": {},
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "traceId": "<string>"
}

{
  "errors": [
    {
      "type": "<string>",
      "code": "<string>",
      "message": "<string>",
      "field": "<string>"
    }
  ],
  "request_id": "<string>"
}

{
  "errors": [
    {
      "type": "<string>",
      "code": "<string>",
      "message": "<string>",
      "field": "<string>"
    }
  ],
  "request_id": "<string>"
}

{
  "errors": [
    {
      "type": "<string>",
      "code": "<string>",
      "message": "<string>",
      "field": "<string>"
    }
  ],
  "request_id": "<string>"
}

{
  "errors": [
    {
      "type": "<string>",
      "code": "<string>",
      "message": "<string>",
      "field": "<string>"
    }
  ],
  "request_id": "<string>"
}

{
  "errors": [
    {
      "type": "<string>",
      "code": "<string>",
      "message": "<string>",
      "field": "<string>"
    }
  ],
  "request_id": "<string>"
}

GET

event-destinations

{destination_id}

Retrieve an event destination

curl --request GET \
  --url https://api.deck.co/v2/event-destinations/{destination_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.deck.co/v2/event-destinations/{destination_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.deck.co/v2/event-destinations/{destination_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.deck.co/v2/event-destinations/{destination_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.deck.co/v2/event-destinations/{destination_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "evtd_AbC123xYz456",
  "object": "<string>",
  "name": "<string>",
  "status": "<string>",
  "type": "webhook",
  "events": [
    "<string>"
  ],
  "created_at": "2026-08-24T12:00:00Z",
  "updated_at": "2026-08-24T12:00:00Z",
  "filter": {},
  "request_id": "<string>",
  "test_endpoint": {
    "inspect_url": "<string>"
  },
  "webhook": {
    "url": "<string>"
  },
  "aws_sqs": {
    "queue_url": "<string>"
  },
  "aws_kinesis": {
    "stream_name": "<string>",
    "region": "<string>"
  },
  "aws_s3": {
    "bucket": "<string>",
    "region": "<string>"
  },
  "aws_eventbridge": {
    "region": "<string>",
    "event_bus_name": "<string>"
  },
  "gcp_pubsub": {
    "project_id": "<string>",
    "topic": "<string>"
  },
  "rabbitmq": {
    "exchange": "<string>",
    "server_url": "<string>"
  },
  "azure_servicebus": {
    "name": "<string>"
  },
  "hookdeck": {},
  "cloudflare_queues": {
    "account_id": "<string>",
    "queue_id": "<string>"
  }
}

{
  "errors": {},
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "traceId": "<string>"
}

{
  "errors": [
    {
      "type": "<string>",
      "code": "<string>",
      "message": "<string>",
      "field": "<string>"
    }
  ],
  "request_id": "<string>"
}

{
  "errors": [
    {
      "type": "<string>",
      "code": "<string>",
      "message": "<string>",
      "field": "<string>"
    }
  ],
  "request_id": "<string>"
}

{
  "errors": [
    {
      "type": "<string>",
      "code": "<string>",
      "message": "<string>",
      "field": "<string>"
    }
  ],
  "request_id": "<string>"
}

{
  "errors": [
    {
      "type": "<string>",
      "code": "<string>",
      "message": "<string>",
      "field": "<string>"
    }
  ],
  "request_id": "<string>"
}

{
  "errors": [
    {
      "type": "<string>",
      "code": "<string>",
      "message": "<string>",
      "field": "<string>"
    }
  ],
  "request_id": "<string>"
}

Authorizations

Authorization

string

header

required

Secret key (sk_live_...)

Path Parameters

destination_id

string

required

Unique identifier for the event destination (prefixed with evtd_).

Pattern: ^evtd_

Example:

"evtd_AbC123xYz456"

Response

An event destination object representing an endpoint that receives platform events.

string

required

Unique identifier for the event destination, prefixed with evtd_.

Pattern: ^evtd_

Example:

"evtd_AbC123xYz456"

object

string

required

Always event_destination.

name

string

required

Display name for the event destination.

status

string

required

Destination status: pending_verification, active, or inactive.

type

enum<string>

required

Destination type. The endpoint configuration is returned under a property whose name equals this value (for example, a webhook destination returns a webhook object).

Available options:

webhook,

aws_sqs,

aws_kinesis,

aws_s3,

aws_eventbridge,

gcp_pubsub,

rabbitmq,

azure_servicebus,

hookdeck,

cloudflare_queues

events

string[]

required

Event types this destination is subscribed to.

created_at

string<date-time>

required

ISO 8601 timestamp of when the resource was created.

Example:

"2026-08-24T12:00:00Z"

updated_at

string<date-time>

required

ISO 8601 timestamp of when the resource was last updated.

Example:

"2026-08-24T12:00:00Z"

filter

null | object

Content filter applied to events before delivery, as written when it was set. null when the destination has no filter.

request_id

null | string

Unique identifier for the API request. Include this when contacting support.

test_endpoint

object | null

Present when the destination is a webhook backed by a disposable Hookdeck Console test endpoint created in the Console. Read-only.

Show child attributes

webhook

object

Configuration returned for a webhook destination (credentials are never returned).

Show child attributes

aws_sqs

object

Configuration returned for a aws_sqs destination (credentials are never returned).

Show child attributes

aws_kinesis

object

Configuration returned for a aws_kinesis destination (credentials are never returned).

Show child attributes

aws_s3

object

Configuration returned for a aws_s3 destination (credentials are never returned).

Show child attributes

aws_eventbridge

object

Configuration returned for a aws_eventbridge destination (credentials are never returned).

Show child attributes

gcp_pubsub

object

Configuration returned for a gcp_pubsub destination (credentials are never returned).

Show child attributes

rabbitmq

object

Configuration returned for a rabbitmq destination (credentials are never returned).

Show child attributes

azure_servicebus

object

Configuration returned for a azure_servicebus destination (credentials are never returned).

Show child attributes

hookdeck

object

Configuration returned for a hookdeck destination (credentials are never returned).

cloudflare_queues

object

Configuration returned for a cloudflare_queues destination (credentials are never returned).

Show child attributes

Agents

Sources

Tasks

Task Runs

Credentials

Sessions

Storage

Triggers

Workflows

Event Destinations

Events

Components

Platform

Test

Retrieve an event destination

Authorizations

Path Parameters

Response