Get task statuses

Retrieves all task statuses configured for the workspace.

What are task statuses? Task statuses represent the progress or phase of a task in its workflow. They help track where tasks are in the process and organize work visually in Kanban boards and lists.

Default statuses: Leadtime comes with standard statuses:

• New: Task has been created but not started
• In Progress: Work is actively being done
• Feedback: Task needs input or review
• Resolved: Task is completed but not yet closed
• Closed: Task is finished and archived
• Backlog: Task is planned for later

Custom statuses: You can create custom statuses based on these types to match your specific workflows. For example, “Design in Progress” (based on In Progress) or “Awaiting Approval” (based on Feedback).

What is returned: An array of task status objects, each containing:

• Status ID, name, and icon
• Status type (New, InProgress, Feedback, Resolved, Closed, Backlog)
• Sort order for display
• Multilingual translations for status name

Note: Only non-deleted statuses are returned. Deleted statuses are soft-deleted and can be restored if needed.

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

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

import requests

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

[
  {
    "icon": ":hourglass_flowing_sand:",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "In Progress",
    "sort": 1,
    "translations": [
      {
        "language": "en",
        "name": "In Progress"
      },
      {
        "language": "de",
        "name": "In Bearbeitung"
      }
    ],
    "type": "InProgress"
  }
]