Get project details
Returns complete project details including all settings, relationships, and metadata.
What is returned: The response includes:
- Basic information: name, short name, type, value group, description, icon
- Classification: category, status, phase, organization
- Access settings: guest access, assigned users and teams
- Task configuration: enabled task types and activities
- Custom data: custom fields, tags
- Responsibilities: default accountable user, responsible user
- Timestamps: creation date, last edit date, archive date
- Project metadata: color, favorite status, express quotations setting
The description field is returned as HTML (converted from the internal IDoc format).
GET
/projects/{id}Authorization
AuthorizationOAuth2 access token · headerrequiredScopes:
api:reador
AuthorizationBearer token (JWT) · headerrequiredPath parameters
idstringrequiredResponses
200
activitiesstring[]requiredArray of time activity IDs enabled for the project
archivedAtobject | nullrequiredArchived timestamp
categoryIdstringrequiredID of the project category
colorstringrequiredProject color (from organization or workspace default)
createdAtstring<date-time>requiredCreation timestamp
customFieldsobjectrequiredCustom fields as key-value pairs
deadlineobject | nullrequiredProject deadline
defaultAccountableIdobject | nullrequiredID of the default accountable user
descriptionstringrequiredProject description (HTML)
editedAtstring<date-time>requiredLast edit timestamp
enableExpressQuotationsbooleanrequiredWhether express quotations are enabled
guestAccessbooleanrequiredWhether guest access is enabled
iconobject | nullrequiredIcon/emoji
idstringrequiredProject ID
isFavoritebooleanrequiredWhether the project is marked as favorite by the current user
namestringrequiredProject name
organizationobject | nullrequiredOrganization details
Show propertiesHide properties
colorstringnamestringshortNamestringorganizationIdobject | nullrequiredID of the organization
phaseIdobject | nullrequiredID of the project phase
responsibleIdobject | nullrequiredID of the responsible user
shortNamestringrequiredProject short name (organization prefix + number)
shortNumbernumberrequiredProject short number
statusIdstringrequiredID of the project status
tagsstring[]requiredArray of tags
taskTypesstring[]requiredArray of task type IDs enabled for the project
teamsstring[]requiredArray of team IDs assigned to the project
typestringrequiredProject type
Allowed:
SingleSupportusersstring[]requiredArray of user IDs assigned to the project
valueGroupstringrequiredValue group classification
Allowed:
DirectValueIndirectValueNonValueWaste401Unauthorized - Invalid or missing authentication token
403Forbidden - Insufficient API scopes or permissions
404Project not found
Request
curl -X GET "https://leadtime.app/api/public/projects/string" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"const response = await fetch("https://leadtime.app/api/public/projects/string", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});import requests
response = requests.get(
"https://leadtime.app/api/public/projects/string",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
},
)Response
{
"activities": [
"550e8400-e29b-41d4-a716-44665544000c",
"550e8400-e29b-41d4-a716-44665544000d"
],
"archivedAt": null,
"categoryId": "550e8400-e29b-41d4-a716-446655440001",
"color": "#FF5733",
"createdAt": "2024-01-01T00:00:00.000Z",
"customFields": {
"customField1": "value1",
"customField2": 123
},
"deadline": "2024-12-31T23:59:59.000Z",
"defaultAccountableId": "550e8400-e29b-41d4-a716-446655440005",
"description": "<h1>Project Description</h1><p>This is a comprehensive project.</p>",
"editedAt": "2024-01-15T10:30:00.000Z",
"enableExpressQuotations": false,
"guestAccess": false,
"icon": "🚀",
"id": "550e8400-e29b-41d4-a716-446655440000",
"isFavorite": false,
"name": "Website Redesign",
"organization": {
"color": "#FF5733",
"name": "ACME Corporation",
"shortName": "ACME"
},
"organizationId": "550e8400-e29b-41d4-a716-446655440004",
"phaseId": "550e8400-e29b-41d4-a716-446655440003",
"responsibleId": "550e8400-e29b-41d4-a716-446655440006",
"shortName": "ACME-123",
"shortNumber": 123,
"statusId": "550e8400-e29b-41d4-a716-446655440002",
"tags": [
"urgent",
"high-priority"
],
"taskTypes": [
"550e8400-e29b-41d4-a716-44665544000a",
"550e8400-e29b-41d4-a716-44665544000b"
],
"teams": [
"550e8400-e29b-41d4-a716-446655440009"
],
"type": "Single",
"users": [
"550e8400-e29b-41d4-a716-446655440007",
"550e8400-e29b-41d4-a716-446655440008"
],
"valueGroup": "DirectValue"
}Unauthorized - Invalid or missing authentication token
Forbidden - Insufficient API scopes or permissions
Project not found