---
title: "GET /v1/brokers"
method: GET
path: "/v1/brokers"
---

# GET /v1/brokers

`GET /v1/brokers`

Returns a list of all brokers.

## Query parameters

- `maxResults` integer
- `nextToken` string
- `MaxResults` string
- `NextToken` string

## Response `200`

Success

- ListBrokersResponse
  - `BrokerSummaries` BrokerSummary[] — A list of information about all brokers.
    - `BrokerArn` string — The broker's Amazon Resource Name (ARN).
    - `BrokerId` string — The unique ID that Amazon MQ generates for the broker.
    - `BrokerName` string — The broker's name. This value is unique in your AWS account, 1-50 characters long, and containing only letters, numbers, dashes, and underscores, and must not contain white spaces, brackets, wildcard characters, or special characters.
    - `BrokerState` 'CREATION_IN_PROGRESS' | 'CREATION_FAILED' | 'DELETION_IN_PROGRESS' | 'RUNNING' | 'REBOOT_IN_PROGRESS' | 'CRITICAL_ACTION_REQUIRED' — The broker's status.
    - `Created` string, date-time — The time when the broker was created.
    - `DeploymentMode` 'SINGLE_INSTANCE' | 'ACTIVE_STANDBY_MULTI_AZ' | 'CLUSTER_MULTI_AZ', required — The broker's deployment mode.
    - `EngineType` 'ACTIVEMQ' | 'RABBITMQ', required — The type of broker engine.
    - `HostInstanceType` string — The broker's instance type.
  - `NextToken` string — The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty.

## Other responses

- `480` — BadRequestException
- `481` — InternalServerErrorException
- `482` — ForbiddenException

---

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