List all project phases

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

What are Project Phases? Phases represent distinct stages or steps within a project lifecycle (e.g., Planning, Development, Testing, Deployment). They provide additional granularity beyond project statuses and are particularly useful for external single projects. Phases can be configured in workspace settings and support multi-language translations.

Phase Types: Each phase has a type that determines its behavior in the project workflow.

What is returned: Each phase includes:

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

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

GET/projects/phases

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Responses

200Project phases retrieved successfully

Array of ProjectPhaseDto

descriptionobject

Phase description

iconstringrequired

Icon identifier in the format `:icon_name:` (e.g., `:calendar:`, `:phone:`, `:trophy:`)

idstringrequired

Project phase ID

namestringrequired

Project phase 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 phase type

Allowed:newinProgressdone

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

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

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

import requests

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

Response

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