List all task statuses

Returns a list of all task statuses configured in the workspace. Task statuses show the progress of a task in the ticket system and represent different phases in the workflow (e.g., New, In Progress, Feedback, Resolved, Closed, Backlog). Each status has a type, icon, sort order, and multilingual translations. This endpoint is optimized for common list data retrieval.

GET/tasks/statuses

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Query parameters

includeDeletedboolean

Include deleted task statuses in the response (default: true)

default: true

Responses

200Task statuses retrieved successfully

Array of TaskStatusDto

deletedbooleanrequired

Whether this task status has been soft-deleted. Deleted statuses are typically hidden from active use but retained for historical data.

iconstringrequired

Icon identifier in the format `:icon_name:` (e.g., `:hourglass_flowing_sand:`, `:check_mark:`, `:x:`). Used for visual representation in task lists, Kanban boards, and status selectors.

idstringrequired

Unique identifier (UUID) for the task status

namestringrequired

Name of the task status (e.g., New, In Progress, Feedback, Resolved, Closed, Backlog). Used for identification in the UI.

sortnumberrequired

Sort order for displaying task statuses in lists and dropdowns. Lower numbers appear first.

translationsTranslationDto[]required

Multilingual translations for the task status name. Supports displaying the status name in different languages based on user preferences.

Show properties

Array of TranslationDto

descriptionobject

Translated description

languagestringrequired

Language code (e.g., en, es, fr)

namestringrequired

Translated name

typestringrequired

Base status type: New, InProgress, Feedback, Backlog, Resolved, or Closed. Defines the semantic meaning and behavior of the status.

Allowed:NewInProgressFeedbackBacklogResolvedClosed

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

curl -X GET "https://leadtime.app/api/public/tasks/statuses" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/tasks/statuses", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/tasks/statuses",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

[
  {
    "deleted": true,
    "icon": "string",
    "id": "string",
    "name": "string",
    "sort": 0,
    "translations": [
      {
        "description": {},
        "language": "string",
        "name": "string"
      }
    ],
    "type": "New"
  }
]