List all project statuses

Returns a list of all project statuses configured in the workspace.

What are Project Statuses? Statuses represent the current progress stage of a project (e.g., Sales, Implementation, Billing, Done). They help track project lifecycle and workflow. Statuses can be configured in workspace settings and support multi-language translations.

Status Types: Each status has a type that determines its behavior in the project workflow.

What is returned: Each status includes:

Unique identifier (ID)
Name and description
Icon identifier
Status type
Multi-language translations (if configured)

This is a read-only endpoint optimized for common list data retrieval.

GET/projects/statuses

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Responses

200Project statuses retrieved successfully

Array of ProjectStatusDto

descriptionobject

Status description

iconstringrequired

Icon identifier in the format `:icon_name:` (e.g., `:hourglass_flowing_sand:`, `:check_mark:`, `:moneybag:`)

idstringrequired

Project status ID

namestringrequired

Project status name

translationsTranslationDto[]required

Translations

Show properties

Array of TranslationDto

descriptionobject

Translated description

languagestringrequired

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

namestringrequired

Translated name

typestringrequired

Project status type

Allowed:SalesRequirementsImplementationQualityManagementBillingDone

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

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

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

import requests

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

Response

[
  {
    "description": {},
    "icon": "string",
    "id": "string",
    "name": "string",
    "translations": [
      {
        "description": {},
        "language": "string",
        "name": "string"
      }
    ],
    "type": "Sales"
  }
]