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/categoriesAuthorization
AuthorizationOAuth2 access token · headerrequiredScopes:
api:reador
AuthorizationBearer token (JWT) · headerrequiredResponses
200Project categories retrieved successfully
Array of
ProjectCategoryDtodescriptionobjectCategory description
iconstringrequiredIcon identifier in the format `:icon_name:` (e.g., `:rocket:`, `:wrench:`, `:briefcase:`)
idstringrequiredProject category ID
namestringrequiredProject category name
translationsTranslationDto[]requiredTranslations
Show propertiesHide properties
Array of
TranslationDtodescriptionobjectTranslated description
languagestringrequiredLanguage code (e.g., en, es, fr)
namestringrequiredTranslated 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"const response = await fetch("https://leadtime.app/api/public/projects/categories", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});import requests
response = requests.get(
"https://leadtime.app/api/public/projects/categories",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
},
)Response
[
{
"description": {},
"icon": "string",
"id": "string",
"name": "string",
"translations": [
{
"description": {},
"language": "string",
"name": "string"
}
]
}
]Unauthorized - Invalid or missing authentication token
Forbidden - Insufficient API scopes or permissions