Skip to content
Testsigma DOCS

Get test case statuses

GET/test_cases/statuses

Base URL  https://test-management.testsigma.com/api/v1

Retrieves the list of available test case statuses used in the test management workflow.

Authenticate with your API key as a Bearer token in the Authorization header. Generate a key →
messageStatus message for the request; may be empty.
data.statuses[].idUnique identifier for the status.
data.statuses[].nameName of the status.
data.statuses[].orderInteger representing the order of the status in the list.
data.statuses[].aliasAlternative name or identifier for the status.
data.statuses[].icon_urlURL pointing to an icon representing the status.
page_info.page_sizeNumber of items returned per page.
page_info.total_countTotal number of statuses available.
page_info.nextURL for the next page of results, if applicable.
page_info.prevURL for the previous page of results, if applicable.
REQUEST
curl -X GET \
  'https://test-management.testsigma.com/api/v1/test_cases/statuses' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json'
const response = await fetch('https://test-management.testsigma.com/api/v1/test_cases/statuses', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  }
});
const data = await response.json();
import requests

response = requests.get(
  'https://test-management.testsigma.com/api/v1/test_cases/statuses',
  headers={
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  }
)
data = response.json()
RESPONSE200OK
{
  "message": "",
  "data": {
    "statuses": [
      {
        "id": "e2a47c91-8b03-4d56-a719-5c8f0e2b6d14",
        "name": "Active",
        "order": 1,
        "alias": "active",
        "icon_url": "https://assets.testsigma.com/icons/statuses/active.svg"
      },
      {
        "id": "f5d18b62-9c47-4a03-bd28-6e9a1f3c0b75",
        "name": "Draft",
        "order": 2,
        "alias": "draft",
        "icon_url": "https://assets.testsigma.com/icons/statuses/draft.svg"
      }
    ]
  },
  "page_info": {
    "page_size": 25,
    "total_count": 2,
    "next": "",
    "prev": ""
  }
}