Skip to content
Leadtime
English
Esc
↑↓navigate↵open⌘Jpreview

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
or
AuthorizationBearer token (JWT) · headerrequired
Responses
200

Project 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
401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it
Server
Authorization
Request
curl -X GET "https://leadtime.app/api/public/projects/phases" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
[
  {
    "description": {},
    "icon": "string",
    "id": "string",
    "name": "string",
    "translations": [
      {
        "description": {},
        "language": "string",
        "name": "string"
      }
    ],
    "type": "new"
  }
]