---
title: "GET /destinations"
method: GET
path: "/destinations"
---

# GET /destinations

`GET /destinations`

Lists all the topic rule destinations in your Amazon Web Services account.

Requires permission to access the [ListTopicRuleDestinations](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Query parameters

- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListTopicRuleDestinationsResponse
  - `destinationSummaries` TopicRuleDestinationSummary[] — Information about a topic rule destination.
    - `arn` string — The topic rule destination ARN.
    - `status` 'ENABLED' | 'IN_PROGRESS' | 'DISABLED' | 'ERROR' | 'DELETING' — <p>The status of the topic rule destination. Valid values are:</p> <dl> <dt>IN_PROGRESS</dt> <dd> <p>A topic rule destination was created but has not been confirmed. You can set <code>status</code> to <code>IN_PROGRESS</code> by calling <code>UpdateTopicRuleDestination</code>. Calling <code>UpdateTopicRuleDestination</code> causes a new confirmation challenge to be sent to your confirmation endpoint.</p> </dd> <dt>ENABLED</dt> <dd> <p>Confirmation was completed, and traffic to this destination is allowed. You can set <code>status</code> to <code>DISABLED</code> by calling <code>UpdateTopicRuleDestination</code>.</p> </dd> <dt>DISABLED</dt> <dd> <p>Confirmation was completed, and traffic to this destination is not allowed. You can set <code>status</code> to <code>ENABLED</code> by calling <code>UpdateTopicRuleDestination</code>.</p> </dd> <dt>ERROR</dt> <dd> <p>Confirmation could not be completed, for example if the confirmation timed out. You can call <code>GetTopicRuleDestination</code> for details about the error. You can set <code>status</code> to <code>IN_PROGRESS</code> by calling <code>UpdateTopicRuleDestination</code>. Calling <code>UpdateTopicRuleDestination</code> causes a new confirmation challenge to be sent to your confirmation endpoint.</p> </dd> </dl>
    - `createdAt` string, date-time — The date and time when the topic rule destination was created.
    - `lastUpdatedAt` string, date-time — The date and time when the topic rule destination was last updated.
    - `statusReason` string — The reason the topic rule destination is in the current status.
    - `httpUrlSummary` object — Information about the HTTP URL.
      - `confirmationUrl` string — The URL used to confirm ownership of or access to the HTTP topic rule destination URL.
    - `vpcDestinationSummary` object — Information about the virtual private cloud (VPC) connection.
      - `subnetIds` SubnetId[] — The subnet IDs of the VPC destination.
      - `securityGroups` SecurityGroupId[] — The security groups of the VPC destination.
      - `vpcId` string — The ID of the VPC.
      - `roleArn` string — The ARN of a role that has permission to create and attach to elastic network interfaces (ENIs).
  - `nextToken` string — The token to use to get the next set of results, or <b>null</b> if there are no additional results.

## Other responses

- `480` — InternalException
- `481` — InvalidRequestException
- `482` — ServiceUnavailableException
- `483` — UnauthorizedException

---

[API](https://skmtc.net/aws/apis/iot.md) · [All operations](https://skmtc.net/aws/apis/iot/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iot/revisions/deef5c4b09f0/schema)