---
title: "Get status category"
method: GET
path: "/rest/api/3/statuscategory/{idOrKey}"
tags: ["Workflow status categories"]
---

# Get status category

`GET /rest/api/3/statuscategory/{idOrKey}`

Returns a status category. Status categories provided a mechanism for categorizing [statuses](#api-rest-api-3-status-idOrName-get).

**[Permissions](#permissions) required:** Permission to access Jira.

## Path parameters

- `idOrKey` string, required

## Response `200`

Returned if the request is successful.

- 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 status category is not found.

---

[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)