# RestAPI for getting workflow step details

**URL:** <https://community.developer.atlassian.com/t/restapi-for-getting-workflow-step-details/86493>\
**Category:** Jira Cloud\
**Tags:** workflow, rest-api\
**Created:** [November 22, 2024, 1:58pm UTC](https://community.developer.atlassian.com/t/restapi-for-getting-workflow-step-details/86493 "2024-11-22T13:58:24Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![AAleksandrov](https://avatars.discourse-cdn.com/v4/letter/a/3bc359/32.png) [@AAleksandrov](https://community.developer.atlassian.com/u/AAleksandrov)\
**Post date:** [November 22, 2024, 1:58pm UTC](https://community.developer.atlassian.com/t/restapi-for-getting-workflow-step-details/86493/1 "2024-11-22T13:58:24Z")

</div>

Hello,  
I am looking for a rest for getting a workflow step properties like these:

 ![image](https://global.discourse-cdn.com/atlassiandeveloper/original/3X/5/2/52cd3aa78836defc5d55cc2ef9c43698623793ad.png)  
 ![image](https://global.discourse-cdn.com/atlassiandeveloper/original/3X/c/3/c3fe100e12a329cc6e3b0d060964be6ff7571174.png)  
Is there any way I can get these programmatically ?  
More specifically I am interested in the approval.active property.  
I need a way to get the workflows for a project, check their statuses and check this approval.active prop of any status.  
I got through the rests for workflows but noone returns the actual steps properties.  
Please advice if there is any way to get these, if not directly from a single rest.

---

<div class="post-metadata">

**Author:** ![anon96974232](https://avatars.discourse-cdn.com/v4/letter/a/7ba0ec/32.png) [@anon96974232](https://community.developer.atlassian.com/u/anon96974232)\
**Post date:** [November 22, 2024, 7:37pm UTC](https://community.developer.atlassian.com/t/restapi-for-getting-workflow-step-details/86493/2 "2024-11-22T19:37:44Z")

</div>

Hello @AAleksandrov

> [@](#):
>
> I got through the rests for workflows but noone returns the actual steps properties.

You’ve read the documentation correctly. There currently are no API endpoints for managing workflow steps or their properties.

Currently you can only manage _transition_ properties.

---

<div class="post-metadata">

**Author:** ![AAleksandrov](https://avatars.discourse-cdn.com/v4/letter/a/3bc359/32.png) [@AAleksandrov](https://community.developer.atlassian.com/u/AAleksandrov)\
**Post date:** [November 25, 2024, 8:23am UTC](https://community.developer.atlassian.com/t/restapi-for-getting-workflow-step-details/86493/3 "2024-11-25T08:23:36Z")

</div>

That’s unfortunate… I need a way to get through the workflows of a project, check their statuses and see if any status has attached approval step.  
Currently I found that it is only available to get if a status has approval step only when a ticket is set to that status, by JQL search with approval=pending(). But this doesn`t work for my needs cause I need to know if such step exist before it is assigned on a ticket.  
If anyone has an idea how can i do that, please advice.

---

<div class="post-metadata">

**Author:** ![AAleksandrov](https://avatars.discourse-cdn.com/v4/letter/a/3bc359/32.png) [@AAleksandrov](https://community.developer.atlassian.com/u/AAleksandrov)\
**Post date:** [November 25, 2024, 11:24am UTC](https://community.developer.atlassian.com/t/restapi-for-getting-workflow-step-details/86493/4 "2024-11-25T11:24:20Z")

</div>

Found a way =\> /rest/api/3/workflow/search?expand=statuses.properties .  
Just saw that there’s an option to expand properties. 🙂

---

<div class="post-metadata">

**Author:** ![anon96974232](https://avatars.discourse-cdn.com/v4/letter/a/7ba0ec/32.png) [@anon96974232](https://community.developer.atlassian.com/u/anon96974232)\
**Post date:** [November 25, 2024, 8:15pm UTC](https://community.developer.atlassian.com/t/restapi-for-getting-workflow-step-details/86493/5 "2024-11-25T20:15:13Z")

</div>

Nice! I hadn’t thought of that.

It’s also where you encounter some strangeness of the workflow terminology used in the GUI versus the API.

For that workflow search endpoint, you can provide _expand_ parameters called `statuses` or `statuses.properties`, but what is actually returned is a set of workflow **steps** and their properties, not any **statuses** linked to those steps or any properties of those statuses.

IMHO, those parameters really should be called `steps` and `steps.properties`

PS. If you solve your own problem, it’s OK to mark your own answer as the solution.

---

<div class="post-metadata">

**Author:** ![MarcelCaroly](https://avatars.discourse-cdn.com/v4/letter/m/977dab/32.png) [@MarcelCaroly](https://community.developer.atlassian.com/u/MarcelCaroly)\
**Post date:** [January 28, 2025, 2:12am UTC](https://community.developer.atlassian.com/t/restapi-for-getting-workflow-step-details/86493/6 "2025-01-28T02:12:17Z")

</div>

Just want to add that I would recommend using the experimental API’s as they provide the full details of the workflow.

- [Get workflows](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-workflows/#api-rest-api-3-workflows-post)
- [Update workflows](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-workflows/#api-rest-api-3-workflows-update-post)

---

<div class="post-metadata">

**Author:** ![davefiery](https://avatars.discourse-cdn.com/v4/letter/d/7feea3/32.png) [@davefiery](https://community.developer.atlassian.com/u/davefiery)\
**Post date:** [March 5, 2025, 1:22am UTC](https://community.developer.atlassian.com/t/restapi-for-getting-workflow-step-details/86493/7 "2025-03-05T01:22:45Z")

</div>

Good catch. One point is that the status that is returned is the Linked Status not the step though which is why status.id won’t get you to the ViewWorkflowStep page. 😕 so it is named correctly status.

I like your idea to have a steps and steps.properties which actually returned the steps and included information about the linked status. I just wasted an hour trying to figure this out.
