List project statuses

Retrieves all project statuses configured for the workspace.

What are Project Statuses? Project statuses describe the major phases a project goes through from planning to completion. They represent the current state of work on a project.

Default status types include:

Sales: Customer is interested and would like an offer
Requirements: Project is being specified and defined
Implementation: Project is being carried out technically or organizationally
Quality Management: Results are being checked
Billing: Project is being invoiced
Done: Job is completely finished

What is returned:

Status ID, name, icon, type, and description
Sort order (for display ordering)
Multilingual translations

Note: The status type determines billing eligibility. Only certain status types allow projects to be billed.

GET/administration/project-settings/statuses

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Responses

200Project statuses retrieved successfully

Array of ProjectStatusResponseDto

descriptionobject

Optional description providing context about when to use this status.

iconstringrequired

Icon identifier in emoji format (e.g., ":hourglass_flowing_sand:"). Displayed next to the status name throughout the application.

idstringrequired

Unique identifier (UUID) for the project status. Used to reference this status when creating or updating projects.

namestringrequired

Display name of the project status. Shown in dropdowns and project lists.

sortnumber

Numeric sort order for display purposes. Lower numbers appear first in lists and dropdowns. May be undefined if not explicitly set.

translationsProjectStatusTranslationDto[]required

Complete array of translations for all supported languages. Each translation contains the language code and localized name/description.

Show properties

Array of ProjectStatusTranslationDto

descriptionobject

Translated description of the project status in this language. Provides context about when to use this status.

languagestringrequired

ISO 639-1 language code for the translation (e.g., "en" for English, "de" for German)

nameobject

Translated name of the project status in this language. Used for multilingual display in the user interface.

typestringrequired

Status type enum value that categorizes the status. Determines billing eligibility and workflow behavior. Valid values: Sales, Requirements, Implementation, QualityManagement, Billing, Done.

Allowed:SalesRequirementsImplementationQualityManagementBillingDone

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

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

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

import requests

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

Response

[
  {
    "description": "Project is currently in development phase",
    "icon": ":hourglass_flowing_sand:",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "In Progress",
    "sort": 1,
    "translations": [
      {
        "description": "Project is currently in progress",
        "language": "en",
        "name": "In Progress"
      },
      {
        "description": "Projekt ist derzeit in Bearbeitung",
        "language": "de",
        "name": "In Bearbeitung"
      }
    ],
    "type": "Implementation"
  }
]