List project phases

Retrieves all project phases (sales pipeline stages) configured for the workspace.

What are Project Phases? Project phases map out the steps a project or lead goes through in the sales process. They are used in the integrated Sales CRM and can be customized to match your sales workflow.

Default phase types include:

Not contacted: Lead has not been approached yet
Research: Information is being gathered about the lead
Contact made: Lead has been reached
Reminder: A follow-up is planned
Not reached: Could not get in touch with the lead
Implementation: Project is confirmed and executed

Phase type values:

new: Initial/starting phase
inProgress: Active work phase
done: Completed/closed phase

What is returned:

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

Note: Phases affect the lanes in the Sales Kanban board. The phase type determines which section of the pipeline the opportunity appears in.

GET/administration/project-settings/phases

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Responses

200Project phases retrieved successfully

Array of ProjectPhaseResponseDto

descriptionobject

Optional description providing context about when to use this phase.

iconstringrequired

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

idstringrequired

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

namestringrequired

Display name of the project phase. Shown in dropdowns and the Sales Kanban board.

sortnumber

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

translationsProjectPhaseTranslationDto[]required

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

Show properties

Array of ProjectPhaseTranslationDto

descriptionobject

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

languagestringrequired

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

nameobject

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

typestringrequired

Phase type enum value that determines which Kanban column the opportunity appears in. Valid values: new, inProgress, done.

Allowed:newinProgressdone

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

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

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

import requests

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

Response

[
  {
    "description": "Initial planning and requirement gathering phase",
    "icon": ":calendar:",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Planning",
    "sort": 1,
    "translations": [
      {
        "description": "Project planning phase",
        "language": "en",
        "name": "Planning"
      },
      {
        "description": "Projektplanungsphase",
        "language": "de",
        "name": "Planung"
      }
    ],
    "type": "new"
  }
]