---
title: "GET /account-associations"
method: GET
path: "/account-associations"
---

# GET /account-associations

`GET /account-associations`

Lists all account associations, with optional filtering by connector destination ID.

## Query parameters

- `ConnectorDestinationId` string
- `MaxResults` integer
- `NextToken` string

## Response `200`

Success

- ListAccountAssociationsResponse
  - `Items` AccountAssociationItem[] — The list of account associations that match the specified criteria.
    - `AccountAssociationId` string, required — The unique identifier of the account association.
    - `AssociationState` 'ASSOCIATION_IN_PROGRESS' | 'ASSOCIATION_FAILED' | 'ASSOCIATION_SUCCEEDED' | 'ASSOCIATION_DELETING' | 'REFRESH_TOKEN_EXPIRED', required — The current state of the account association, indicating its status in the association lifecycle.
    - `ErrorMessage` string — The error message explaining any issues with the account association, if applicable.
    - `ConnectorDestinationId` string — The identifier of the connector destination associated with this account association.
    - `Name` string — The name of the account association.
    - `Description` string — A description of the account association.
    - `Arn` string — The Amazon Resource Name (ARN) of the account association.
  - `NextToken` string — A token used for pagination of results when there are more account associations than can be returned in a single response.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — InternalServerException
- `483` — ServiceUnavailableException
- `484` — ThrottlingException

---

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