---
title: "Get workflow usages by status"
method: GET
path: "/rest/api/2/statuses/{statusId}/workflowUsages"
tags: ["Status"]
---

# Get workflow usages by status

`GET /rest/api/2/statuses/{statusId}/workflowUsages`

Returns a page of workflows using a given status.

## Path parameters

- `statusId` string, required

## Query parameters

- `nextPageToken` string
- `maxResults` integer

## Response `200`

Returned if the request is successful.

- StatusWorkflowUsageDTO — Workflows using the status.
  - `statusId` string — The status ID.
  - `workflows` StatusWorkflowUsagePage — A page of workflows.
    - `nextPageToken` string — Page token for the next page of issue type usages.
    - `values` StatusWorkflowUsageWorkflow[] — The list of statuses.
      - `id` string — The workflow ID.

## Other responses

- `400` — Returned if the request is not valid.
- `401` — Returned if the authentication credentials are incorrect or missing, or the caller doesn't have permissions to perform the operation.
- `404` — Returned if the status with the given ID does not exist.

---

[API](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api.md) · [All operations](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api/revisions/7e9af75061ea/schema)