List project categories

Retrieves all project categories configured for the workspace.

What are Project Categories? Project categories are used to sort projects by type or purpose. Examples include:

New client project
Change request
Service order

This categorization makes it easier to analyze project data, for example comparing revenue from existing clients versus new ones.

What is returned:

Category ID, name, icon, and description
Sort order (for display ordering)
Multilingual translations (name and description in multiple languages)

Note: All project categories support bilingual labels. The translations array contains localized names and descriptions that are automatically shown based on the user interface language.

GET/administration/project-settings/categories

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Responses

200Project categories retrieved successfully

Array of ProjectCategoryResponseDto

descriptionobject

Optional description providing context about when to use this category.

iconstringrequired

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

idstringrequired

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

namestringrequired

Display name of the project category. Shown in dropdowns and project lists.

sortnumber

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

translationsProjectCategoryTranslationDto[]required

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

Show properties

Array of ProjectCategoryTranslationDto

descriptionobject

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

languagestringrequired

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

nameobject

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

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

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

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

import requests

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

Response

[
  {
    "description": "Projects related to software development",
    "icon": ":rocket:",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Development",
    "sort": 1,
    "translations": [
      {
        "description": "Software development projects",
        "language": "en",
        "name": "Development"
      },
      {
        "description": "Softwareentwicklungsprojekte",
        "language": "de",
        "name": "Entwicklung"
      }
    ]
  }
]