provider Workflows POST /rest/api/3/workflow/history/list
@utdk/jira /rest/api/3/workflow/history/list
List workflow history entries
Returns a list of workflow history entries for a specified workflow id. **Note:** Stored workflow data expires after 60 days. Additionally, no data from before the 30th of October 2025 is available. **[Permissions](#permissions) required:** * *Administer Jira* global permission to access all, including project-scoped, workflows * At least one of the *Administer projects* and *View (read-only) workflow* project permissions to access project-scoped workflows
expand query
Use [expand](#expansion) to include additional information in the response. This parameter accepts a comma-separated list. Expand options include: * `includeIntermediateWorkflows` Includes intermediate workflow versions that are sometimes created during workflow updates or migrations. By default, these are omitted from the response.
string

Try it

Authentication
Configure credentials for The Jira Cloud platform REST API
Gateway
The gateway proxies requests and injects credentials server-side. Configure credentials above, then enter your gateway URL.

Saved automatically to browser storage.

listworkflowhistory
POST/rest/api/3/workflow/history/list
Returns a list of workflow history entries for a specified workflow id. **Note:** Stored workflow data expires after 60 days. Additionally, no data from before the 30th of October 2025 is available. **[Permissions](#permissions) required:** * *Administer Jira* global permission to access all, including project-scoped, workflows * At least one of the *Administer projects* and *View (read-only) workflow* project permissions to access project-scoped workflows

Use [expand](#expansion) to include additional information in the response. This parameter accepts a comma-separated list. Expand options include: * `includeIntermediateWorkflows` Includes intermediate workflow versions that are sometimes created during workflow updates or migrations. By default, these are omitted from the response.

Input

The id of the workflow to read the history for.

Enter a gateway URL above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import jira from '@utdk/jira';

await jira.listworkflowhistory()