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

# GET /agent-status/{InstanceId}

`GET /agent-status/{InstanceId}`

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

Lists agent statuses.

## Path parameters

- `InstanceId` string, required

## Query parameters

- `nextToken` string
- `maxResults` integer
- `AgentStatusTypes` AgentStatusType[]
- `MaxResults` string
- `NextToken` string

## Response `200`

Success

- ListAgentStatusResponse
  - `NextToken` string — If there are additional results, this is the token for the next set of results.
  - `AgentStatusSummaryList` AgentStatusSummary[] — A summary of agent statuses.
    - `Id` string — The identifier for an agent status.
    - `Arn` string — The Amazon Resource Name (ARN) for the agent status.
    - `Name` string — The name of the agent status.
    - `Type` 'ROUTABLE' | 'CUSTOM' | 'OFFLINE' — The type of the agent status.

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