Get project status details

Retrieves detailed information about a specific project status by its ID.

What is returned:

Status ID, name, icon, type, and description
Sort order
Complete translations array with all language variants

Use cases:

Display status details in a form
Verify status exists before updating
Retrieve full translation set for editing

GET/administration/project-settings/statuses/{id}

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstringrequired

Responses

200

Project status retrieved successfully

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

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

idpath*

Request

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

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

import requests

response = requests.get(
    "https://leadtime.app/api/public/administration/project-settings/statuses/string",
    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"
}