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

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

Project 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
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/statuses" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
[
  {
    "description": {},
    "icon": "string",
    "id": "string",
    "name": "string",
    "translations": [
      {
        "description": {},
        "language": "string",
        "name": "string"
      }
    ],
    "type": "Sales"
  }
]