---
title: "Get transitions"
method: GET
path: "/rest/api/3/issue/{issueIdOrKey}/transitions"
tags: ["Issues"]
---

# Get transitions

`GET /rest/api/3/issue/{issueIdOrKey}/transitions`

Returns either all transitions or a transition that can be performed by the user on an issue, based on the issue's status.

Note, if a request is made for a transition that does not exist or cannot be performed on the issue, given its status, the response will return any empty transitions list.

This operation can be accessed anonymously.

**[Permissions](#permissions) required: A list or transition is returned only when the user has:**

 *  *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in.
 *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue.

However, if the user does not have the *Transition issues* [ project permission](https://confluence.atlassian.com/x/yodKLg) the response will not list any transitions.

## Path parameters

- `issueIdOrKey` string, required

## Query parameters

- `expand` string
- `transitionId` string
- `skipRemoteOnlyCondition` boolean
- `includeUnavailableTransitions` boolean
- `sortByOpsBarAndStatus` boolean

## Response `200`

Returned if the request is successful.

- Transitions — List of issue transitions.
  - `expand` string — Expand options that include additional transitions details in the response.
  - `transitions` IssueTransition[] — List of issue transitions.
    - `expand` string — Expand options that include additional transition details in the response.
    - `fields` object — Details of the fields associated with the issue transition screen. Use this information to populate `fields` and `update` in a transition request.
    - `hasScreen` boolean — Whether there is a screen associated with the issue transition.
    - `id` string — The ID of the issue transition. Required when specifying a transition to undertake.
    - `isAvailable` boolean — Whether the transition is available to be performed.
    - `isConditional` boolean — Whether the issue has to meet criteria before the issue transition is applied.
    - `isGlobal` boolean — Whether the issue transition is global, that is, the transition is applied to issues regardless of their status.
    - `isInitial` boolean — Whether this is the initial issue transition for the workflow.
    - `looped` boolean
    - `name` string — The name of the issue transition.
    - `to` StatusDetails — A status.
      - `description` string — The description of the status.
      - `iconUrl` string — The URL of the icon used to represent the status.
      - `id` string — The ID of the status.
      - `name` string — The name of the status.
      - `scope` Scope — The projects the item is associated with. Indicated for items associated with [next-gen projects](https://confluence.atlassian.com/x/loMyO).
        - `project` ProjectDetails — Details about a project.
          - `avatarUrls` AvatarUrlsBean
            - `16x16` string, uri — The URL of the item's 16x16 pixel avatar.
            - `24x24` string, uri — The URL of the item's 24x24 pixel avatar.
            - `32x32` string, uri — The URL of the item's 32x32 pixel avatar.
            - `48x48` string, uri — The URL of the item's 48x48 pixel avatar.
          - `id` string — The ID of the project.
          - `key` string — The key of the project.
          - `name` string — The name of the project.
          - `projectCategory` UpdatedProjectCategory — A project category.
            - `description` string — The name of the project category.
            - `id` string — The ID of the project category.
            - `name` string — The description of the project category.
            - `self` string — The URL of the project category.
          - `projectTypeKey` 'software' | 'service_desk' | 'business' — The [project type](https://confluence.atlassian.com/x/GwiiLQ#Jiraapplicationsoverview-Productfeaturesandprojecttypes) of the project.
          - `self` string — The URL of the project details.
          - `simplified` boolean — Whether or not the project is simplified.
        - `type` 'PROJECT' | 'TEMPLATE' — The type of scope.
      - `self` string — The URL of the status.
      - `statusCategory` StatusCategory — A status category.
        - `colorName` string — The name of the color used to represent the status category.
        - `id` integer — The ID of the status category.
        - `key` string — The key of the status category.
        - `name` string — The name of the status category.
        - `self` string — The URL of the status category.

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing.
- `404` — Returned if the issue is not found or the user does not have permission to view it.

---

[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/5a51740d7ab3/schema)