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

# List event destinations

`GET /event-destinations`

Returns a paginated list of event destinations.

## Query parameters

- `limit` union
  - integer
  - string, int32
- `cursor` string

## Response `200`

OK

- PaginatedResponseOfEventDestinationResponse
  - `data` EventDestinationResponse[] — Array of resource objects for the current page.
    - `id` string, required — Unique identifier for the event destination, prefixed with `evtd_`.
    - `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` 'webhook' | 'aws_sqs' | 'aws_kinesis' | 'aws_s3' | 'aws_eventbridge' | 'gcp_pubsub' | 'rabbitmq' | 'azure_servicebus' | 'hookdeck', 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).
    - `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.
    - `updated_at` string, date-time, required — ISO 8601 timestamp of when the resource was last updated.
    - `request_id` string, nullable — Unique identifier for the API request. Include this when contacting support.
    - `webhook` object — Configuration returned for a `webhook` destination (credentials are never returned).
      - `url` string, required — Absolute `https` or `http` URL that receives event deliveries.
    - `aws_sqs` object — Configuration returned for a `aws_sqs` destination (credentials are never returned).
      - `queue_url` string, required — URL of the destination Amazon SQS queue.
    - `aws_kinesis` object — Configuration returned for a `aws_kinesis` destination (credentials are never returned).
      - `stream_name` string, required — Name of the Amazon Kinesis stream.
      - `region` string, required — AWS region of the stream.
    - `aws_s3` object — Configuration returned for a `aws_s3` destination (credentials are never returned).
      - `bucket` string, required — Name of the destination Amazon S3 bucket.
      - `region` string, required — AWS region of the bucket.
    - `aws_eventbridge` object — Configuration returned for a `aws_eventbridge` destination (credentials are never returned).
      - `event_bus_name` string, required — Name of the Amazon EventBridge event bus.
      - `region` string, required — AWS region of the event bus.
    - `gcp_pubsub` object — Configuration returned for a `gcp_pubsub` destination (credentials are never returned).
      - `project_id` string, required — Google Cloud project ID.
      - `topic` string, required — Pub/Sub topic name. Accepted alias: `topic_name`.
    - `rabbitmq` object — Configuration returned for a `rabbitmq` destination (credentials are never returned).
      - `exchange` string, required — Name of the RabbitMQ exchange.
      - `server_url` string, required — RabbitMQ host as `host[:port]` (for example `rabbitmq:5672`). You may instead pass a full AMQP URL with embedded credentials; Deck extracts the host, username, and password from it.
    - `azure_servicebus` object — Configuration returned for a `azure_servicebus` destination (credentials are never returned).
      - `name` string, required — Name of the Service Bus queue or topic. Accepted alias: `queue_name`.
    - `hookdeck` object — Configuration returned for a `hookdeck` destination (credentials are never returned).
  - `has_more` boolean — `true` if there are more results beyond this page.
  - `next_cursor` string, nullable — Opaque cursor string to pass as the `cursor` query parameter on the next request. `null` when there are no more pages.
  - `request_id` string, nullable — Unique identifier for the API request.

## Other responses

- `400` — Bad request — validation error or malformed input.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Not found — the requested resource does not exist.
- `409` — Conflict — the request is valid but cannot be completed in the current state.
- `422` — Unprocessable content — the request body is understood but contains invalid values.
- `429` — Too many requests or session concurrency exceeded. Retry with backoff; honor Retry-After and RateLimit headers when present.
- `500` — Internal server error.

---

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