---
title: "Get customer request status"
method: GET
path: "/rest/servicedeskapi/request/{issueIdOrKey}/status"
tags: ["Request"]
---

# Get customer request status

`GET /rest/servicedeskapi/request/{issueIdOrKey}/status`

This method returns a list of all the statuses a customer Request has achieved. A status represents the state of an issue in its workflow. An issue can have one active status only. The list returns the status history in chronological order, most recent (current) status first.

**[Permissions](#permissions) required**: Permission to view the customer request.

## Path parameters

- `issueIdOrKey` string, required

## Query parameters

- `start` integer
- `limit` integer

## Response `200`

Returns the customer request's status history, on the specified page of the results.

- PagedDTOCustomerRequestStatusDTO
  - `_expands` string[]
  - `_links` PagedLinkDTO
    - `base` string, uri — Base URL for the REST API calls.
    - `context` string
    - `next` string, uri — REST API URL for the next page, if there is one.
    - `prev` string, uri — REST API URL for the previous page, if there is one.
    - `self` string, uri — REST API URL for the current page.
  - `isLastPage` boolean — Indicates if this is the last page of records (true) or not (false).
  - `limit` integer — Number of items to be returned per page, up to the maximum set for these objects in the current implementation.
  - `size` integer — Number of items returned in the page.
  - `start` integer — Index of the first item returned in the page.
  - `values` CustomerRequestStatusDTO[] — Details of the items included in the page.
    - `status` string — Name of the status condition.
    - `statusCategory` 'UNDEFINED' | 'NEW' | 'INDETERMINATE' | 'DONE' — Status category the status belongs to.
    - `statusDate` DateDTO
      - `epochMillis` integer — Date as the number of milliseconds that have elapsed since 00:00:00 Coordinated Universal Time (UTC), 1 January 1970.
      - `friendly` string — Date in a user-friendly text format.
      - `iso8601` string — Date in ISO8601 format.
      - `jira` string — Date in the format used in the Jira REST APIs, which is ISO8601 format but extended with milliseconds. For example, 2016-09-28T23:08:32.097+1000.

## Other responses

- `401` — Returned if the user is not logged in.
- `403` — Returned if the user does not have permission to complete this request.
- `404` — Returned if the customer request is not found.
- `500` — Internal Server Error.

---

[API](https://skmtc.net/atlassian/apis/service-management-public-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/service-management-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/service-management-public-rest-api/versions/d1dc1a13b783/schema)
