Zum Inhalt springen
Leadtime
Deutsch
Esc
navigateopen⌘Jpreview

List all project categories

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

What are Project Categories? Categories classify projects by functional area or project type (e.g., Onboarding, Support, Implementation, Website Development). They help organize and filter projects in the workspace. Categories can be configured in workspace settings and support multi-language translations.

What is returned: Each category includes:

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

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

GET/projects/categories
Authorization
AuthorizationOAuth2 access token · headerrequired
Scopes:api:read
or
AuthorizationBearer token (JWT) · headerrequired
Responses
200Project categories retrieved successfully
Array of ProjectCategoryDto
descriptionobject
Category description
iconstringrequired
Icon identifier in the format `:icon_name:` (e.g., `:rocket:`, `:wrench:`, `:briefcase:`)
idstringrequired
Project category ID
namestringrequired
Project category name
translationsTranslationDto[]required
Translations
Show properties
Array of TranslationDto
descriptionobject
Translated description
languagestringrequired
Language code (e.g., en, es, fr)
namestringrequired
Translated name
401Unauthorized - Invalid or missing authentication token
403Forbidden - Insufficient API scopes or permissions
Request
curl -X GET "https://leadtime.app/api/public/projects/categories" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
[
  {
    "description": {},
    "icon": "string",
    "id": "string",
    "name": "string",
    "translations": [
      {
        "description": {},
        "language": "string",
        "name": "string"
      }
    ]
  }
]