---
title: "Get available transitions"
method: GET
path: "/rest/api/3/bulk/issues/transition"
tags: ["Issue bulk operations"]
---

# Get available transitions

`GET /rest/api/3/bulk/issues/transition`

Use this API to retrieve a list of transitions available for the specified issues that can be used or bulk transition operations. You can submit either single or multiple issues in the query to obtain the available transitions.

The response will provide the available transitions for issues, organized by their respective workflows. **Only the transitions that are common among the issues within that workflow and do not involve any additional field updates will be included.** For bulk transitions that require additional field updates, please utilise the Jira Cloud UI.

You can request available transitions for up to 1,000 issues in a single operation. This API uses pagination to return responses, delivering 50 workflows at a time.

**[Permissions](#permissions) required:**

 *  Global bulk change [permission](https://support.atlassian.com/jira-cloud-administration/docs/manage-global-permissions/).
 *  Transition [issues permission](https://support.atlassian.com/jira-cloud-administration/docs/permissions-for-company-managed-projects/#Transition-issues/) in all projects that contain the selected issues.
 *  Browse [project permission](https://support.atlassian.com/jira-cloud-administration/docs/manage-project-permissions/) in all projects that contain the selected issues.
 *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue.

## Query parameters

- `issueIdsOrKeys` string, required
- `endingBefore` string
- `startingAfter` string

## Response `200`

Returned if the request is successful.

- BulkTransitionGetAvailableTransitions — Bulk Transition Get Available Transitions Response.
  - `availableTransitions` IssueBulkTransitionForWorkflow[] — List of available transitions for bulk transition operation for requested issues grouped by workflow
    - `isTransitionsFiltered` boolean — Indicates whether all the transitions of this workflow are available in the transitions list or not.
    - `issues` string[] — List of issue keys from the request which are associated with this workflow.
    - `transitions` SimplifiedIssueTransition[] — List of transitions available for issues from the request which are associated with this workflow. **This list includes only those transitions that are common across the issues in this workflow and do not involve any additional field updates.**
      - `to` IssueTransitionStatus
        - `statusId` integer — The unique ID of the status.
        - `statusName` string — The name of the status.
      - `transitionId` integer — The unique ID of the transition.
      - `transitionName` string — The name of the transition.
  - `endingBefore` string — The end cursor for use in pagination.
  - `startingAfter` string — The start cursor for use in pagination.

## Other responses

- `400` — Returned if the request is not valid. For example, if a provided issue ID or key is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have the necessary permission.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/ec7f275dfee5/schema)