---
title: Get Jira issue transitions
source: https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/jira/jira-issue-gettransitions
---

Gets the available statuses to which a Jira issue can transition. Use this action to retrieve transition IDs before calling the [Transition a Jira issue](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/jira/jira-issue-dotransition) action.

For authentication setup, see [Jira issue actions](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/jira/jira-issue).

## Inputs

| Input Field    | Optionality | Type   | Description                                                                                                                                                                                         | Example                                                               |
| -------------- | ----------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| **authToken**  | Required    | String | Base64-encoded string of `email:API_Token` for Basic Authentication. Must be provided as a secret. See [Create and manage API tokens](https://id.atlassian.com/manage-profile/security/api-tokens). | `"${{ :secrets:jiraAuthToken }}"`                                     |
| **domain**     | Required    | String | Your Jira Cloud instance domain (company name). Used to construct the base URL `your-domain.atlassian.net`.                                                                                         | `"mycompany"`                                                         |
| **issueKey**   | Required    | String | The key of the Jira issue to get transitions for.                                                                                                                                                   | `"PROJ-1234"`                                                         |
| **parameters** | Optional    | Map    | Optional URL query parameters for the Jira API request. See the parameters reference table below.                                                                                                   | `{"fields": "summary,status", "expand": "transitions"}`               |
| **selectors**  | Optional    | List   | A list of named expressions to extract specific values from the response.                                                                                                                           | `[{"name": "summary", "expression": ".responseBody.result.summary"}]` |

> #### ⚠️ PARAMETERS REFERENCE
>
> | Parameter                         | Type    | Description                                                                                                                                                                                                                                                                                                                                                                       | Default |
> | --------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
> | **expand**                        | String  | Use `transitions.fields` to return information about the fields in the transition screen for each transition. Fields hidden from the screen are not returned. Use this to populate the `fields` and `update` inputs in the [Transition a Jira issue](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/jira/jira-issue-dotransition) action. |         |
> | **transitionId**                  | String  | Filter results to a specific transition by its ID.                                                                                                                                                                                                                                                                                                                                |         |
> | **skipRemoteOnlyCondition**       | Boolean | Whether to include transitions with the condition _Hide From User Condition_ in the response. Available to Connect and Forge app users with _Administer Jira_ global permission.                                                                                                                                                                                                  | `false` |
> | **includeUnavailableTransitions** | Boolean | Whether to include details of transitions that fail a condition in the response.                                                                                                                                                                                                                                                                                                  | `false` |
> | **sortByOpsBarAndStatus**         | Boolean | When `true`, transitions are sorted by ops-bar sequence value first, then by category order (Todo, In Progress, Done). When `false`, sorted only by ops-bar sequence value.                                                                                                                                                                                                       | `false` |

## Outputs

| Output Field     | Type    | Example                                                                                                              |
| ---------------- | ------- | -------------------------------------------------------------------------------------------------------------------- |
| **response**     | Object  | ```yaml {   "id": "151",   "name": "Selected for Development",   ... } ```                                           |
| **success**      | Boolean | `success: true | false`                                                                                              |
| **errorMessage** | String  | ```yaml {   "errorMessages": ["Issue does not exist or you do not have permission to see it."],   "errors": {} } ``` |

## Example

| Workflow example                                                                                                                                                                                                                                                                                                                                                                              |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ```yaml name: get-jira-issue-transitions description: 'Get available transitions for a Jira issue' steps:   - name: get_transitions     type: action     action: jira.issue.getTransitions     version: 1     inputs:       authToken: ${{ :secrets:jiraAuthToken }}       domain: mycompany       issueKey: PROJ-567       parameters:         sortByOpsBarAndStatus: true     next: end ``` |