---
title: "GET /traffic-distribution-group/{TrafficDistributionGroupId}"
method: GET
path: "/traffic-distribution-group/{TrafficDistributionGroupId}"
---

# GET /traffic-distribution-group/{TrafficDistributionGroupId}

`GET /traffic-distribution-group/{TrafficDistributionGroupId}`

Gets details and status of a traffic distribution group.

## Path parameters

- `TrafficDistributionGroupId` string, required

## Response `200`

Success

- DescribeTrafficDistributionGroupResponse
  - `TrafficDistributionGroup` object — Information about the traffic distribution group.
    - `Id` string — The identifier of the traffic distribution group. This can be the ID or the ARN if the API is being called in the Region where the traffic distribution group was created. The ARN must be provided if the call is from the replicated Region.
    - `Arn` string — The Amazon Resource Name (ARN) of the traffic distribution group.
    - `Name` string — The name of the traffic distribution group.
    - `Description` string — The description of the traffic distribution group.
    - `InstanceArn` string — The Amazon Resource Name (ARN).
    - `Status` 'CREATION_IN_PROGRESS' | 'ACTIVE' | 'CREATION_FAILED' | 'PENDING_DELETION' | 'DELETION_FAILED' | 'UPDATE_IN_PROGRESS' — <p>The status of the traffic distribution group.</p> <ul> <li> <p> <code>CREATION_IN_PROGRESS</code> means the previous <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html">CreateTrafficDistributionGroup</a> operation is still in progress and has not yet completed.</p> </li> <li> <p> <code>ACTIVE</code> means the previous <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html">CreateTrafficDistributionGroup</a> operation has succeeded.</p> </li> <li> <p> <code>CREATION_FAILED</code> indicates that the previous <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html">CreateTrafficDistributionGroup</a> operation has failed.</p> </li> <li> <p> <code>PENDING_DELETION</code> means the previous <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteTrafficDistributionGroup.html">DeleteTrafficDistributionGroup</a> operation is still in progress and has not yet completed.</p> </li> <li> <p> <code>DELETION_FAILED</code> means the previous <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteTrafficDistributionGroup.html">DeleteTrafficDistributionGroup</a> operation has failed.</p> </li> <li> <p> <code>UPDATE_IN_PROGRESS</code> means the previous <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistributionGroup.html">UpdateTrafficDistributionGroup</a> operation is still in progress and has not yet completed.</p> </li> </ul>
    - `Tags` object — The tags used to organize, track, or control access for this resource. For example, { "tags": {"key1":"value1", "key2":"value2"} }.

## Other responses

- `480` — InvalidRequestException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — InternalServiceException
- `484` — ThrottlingException

---

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