---
title: "Retrieves existing queues."
method: GET
path: "/routing/queues"
---

# Retrieves existing queues.

`GET /routing/queues`

Retrieves existing queues.

## Query parameters

- `api-version` string, required
- `maxpagesize` integer

## Response `200`

The request has succeeded.

- PagedRouterQueue — Paged collection of RouterQueue items
  - `value` RouterQueue[], required — The RouterQueue items on this page
    - `etag` string, required — The ETag (or entity tag) HTTP response header is an identifier for a specific version of a resource. It lets caches be more efficient and save bandwidth, as a web server does not need to resend a full response if the content was not changed. It is a string of ASCII characters placed between double quotes, like "675af34563dc-tr34".
    - `id` string, required — Id of a queue.
    - `name` string — Friendly name of this queue.
    - `distributionPolicyId` string — Id of a distribution policy that will determine how a job is distributed to workers.
    - `labels` object — A set of key/value pairs that are identifying attributes used by the rules engines to make decisions. Values must be primitive values - number, string, boolean.
    - `exceptionPolicyId` string — Id of an exception policy that determines various job escalation rules.
  - `nextLink` string, uri — The link to the next page of items

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** `fe2019dcc5b0` — 2 info
  - api operation id `JobRouterAdministration_ListQueues` removed and replaced with `JobRouterAdministrationOperations_ListQueues`
  - api tag `Queues` removed
- **2026-07-13** `1a6c28227c55` — 1 info
  - api operation id `JobRouter_ListQueues` removed and replaced with `JobRouterAdministration_ListQueues`
- **2022-05-05** `8cbeaf5a7ce3` — 1 warning, 2 info
  - the optional response header `x-ms-error-code` removed for the status `default`
  - api operation id `JobRouterAdministrationOperations_ListQueues` removed and replaced with `JobRouter_ListQueues`
  - api tag `Queues` added

[Change history](https://skmtc.dev/azure/apis/communication-jobrouter/changes/routing/queues/get.md)

---

[API](https://skmtc.dev/azure/apis/communication-jobrouter.md) · [All operations](https://skmtc.dev/azure/apis/communication-jobrouter/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/communication-jobrouter/revisions/c06e8f55d8b7/schema)