---
title: "Get status"
method: GET
path: "/rest/api/3/status/{idOrName}"
tags: ["Workflow statuses"]
---

# Get status

`GET /rest/api/3/status/{idOrName}`

Returns a status. The status must be associated with an active workflow to be returned.

If a name is used on more than one status, only the status found first is returned. Therefore, identifying the status by its ID may be preferable.

This operation can be accessed anonymously.

[Permissions](#permissions) required: *Browse projects* [project permission](https://support.atlassian.com/jira-cloud-administration/docs/manage-project-permissions/) for the project.

## Path parameters

- `idOrName` string, required

## Response `200`

Returned if the request is successful.

- StatusDetails — A status.
  - `description` string — The description of the status.
  - `iconUrl` string — The URL of the icon used to represent the status.
  - `id` string — The ID of the status.
  - `name` string — The name of the status.
  - `scope` Scope — The projects the item is associated with. Indicated for items associated with [next-gen projects](https://confluence.atlassian.com/x/loMyO).
    - `project` ProjectDetails — Details about a project.
      - `avatarUrls` AvatarUrlsBean
        - `16x16` string, uri — The URL of the item's 16x16 pixel avatar.
        - `24x24` string, uri — The URL of the item's 24x24 pixel avatar.
        - `32x32` string, uri — The URL of the item's 32x32 pixel avatar.
        - `48x48` string, uri — The URL of the item's 48x48 pixel avatar.
      - `id` string — The ID of the project.
      - `key` string — The key of the project.
      - `name` string — The name of the project.
      - `projectCategory` UpdatedProjectCategory — A project category.
        - `description` string — The name of the project category.
        - `id` string — The ID of the project category.
        - `name` string — The description of the project category.
        - `self` string — The URL of the project category.
      - `projectTypeKey` 'software' | 'service_desk' | 'business' — The [project type](https://confluence.atlassian.com/x/GwiiLQ#Jiraapplicationsoverview-Productfeaturesandprojecttypes) of the project.
      - `self` string — The URL of the project details.
      - `simplified` boolean — Whether or not the project is simplified.
    - `type` 'PROJECT' | 'TEMPLATE' — The type of scope.
  - `self` string — The URL of the status.
  - `statusCategory` 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 is not found. * the status is not associated with a workflow. * the user does not have the required permissions.

---

[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/ec7f275dfee5/schema)