---
title: "GET /agent-status/{InstanceId}/{AgentStatusId}"
method: GET
path: "/agent-status/{InstanceId}/{AgentStatusId}"
---

# GET /agent-status/{InstanceId}/{AgentStatusId}

`GET /agent-status/{InstanceId}/{AgentStatusId}`

This API is in preview release for Amazon Connect and is subject to change.

Describes an agent status.

## Path parameters

- `InstanceId` string, required
- `AgentStatusId` string, required

## Response `200`

Success

- DescribeAgentStatusResponse
  - `AgentStatus` object — The agent status.
    - `AgentStatusARN` string — The Amazon Resource Name (ARN) of the agent status.
    - `AgentStatusId` string — The identifier of the agent status.
    - `Name` string — The name of the agent status.
    - `Description` string — The description of the agent status.
    - `Type` 'ROUTABLE' | 'CUSTOM' | 'OFFLINE' — The type of agent status.
    - `DisplayOrder` integer — The display order of the agent status.
    - `State` 'ENABLED' | 'DISABLED' — The state of the agent status.
    - `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` — InvalidParameterException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — InternalServiceException

---

[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)