---
title: "List merge queues"
method: GET
path: "/repositories/{workspace}/{repo_slug}/merge-queues"
tags: ["Merge queues"]
---

# List merge queues

`GET /repositories/{workspace}/{repo_slug}/merge-queues`

## Request

- Base URL: `https://api.bitbucket.org/2.0`
- URL: `https://api.bitbucket.org/2.0/repositories/{workspace}/{repo_slug}/merge-queues`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://bitbucket.org/site/oauth2/authorize`
    - Token URL: `https://bitbucket.org/site/oauth2/access_token` scopes: `repository`
  - HTTP basic
  - API key in header `Authorization`

Lists merge queues configured for a repository. Optionally filter by branch.

## Path parameters

- `workspace` string, required
- `repo_slug` string, required

## Query parameters

- `target_branch` string
- `page` integer
- `pagelen` integer

## Response `200`

Merge queues retrieved successfully.

- PaginatedMergeQueues
  - `page` integer
  - `size` integer
  - `pagelen` integer
  - `values` MergeQueue[]
    - `type` string, required
    - `uuid` string, required: The merge queue UUID.
    - `name` string, required: The merge queue name.
    - `state` string, required: The configuration state returned by the merge queue service. Known values are `ACTIVE`, `PAUSED`, `DRAINING`, `SUSPENDED`, `INACTIVE`, and `UNKNOWN`. `ACTIVE` accepts entries; `PAUSED` accepts entries but pauses landing; `DRAINING` and `SUSPENDED` block entry; `INACTIVE` does not require queueing. Unknown values are returned unchanged and follow the existing queue behavior: only `DRAINING` and `SUSPENDED` block entry.

## Other responses

- `401`: Authentication is required.
- `403`: The caller does not have read access to the repository.
- `404`: The repository does not exist.

## Changes

- **2026-10-21** `6ae783fa75da`: 2 info
  - api tag `Merge queues` added
  - api tag `Merge Queues` removed
- **2026-10-17** `99ec5e1b92e9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/atlassian/apis/bitbucket-api/changes/repositories/:workspace/:repo_slug/merge-queues/get.md)

---

[API](https://skmtc.dev/atlassian/apis/bitbucket-api.md) - [All operations](https://skmtc.dev/atlassian/apis/bitbucket-api/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/bitbucket-api/revisions/6ae783fa75da?raw)