List projects
Returns a paginated, filterable list of projects visible to the authenticated user. Users with full project visibility see all projects; restricted users receive only projects they can access, or an empty list.
What are Projects? Projects are the central organizational unit in Leadtime. Every task, time booking, and activity is associated with a project. Projects can be either internal (company activities) or external (client work), and can be structured as single projects (one-off initiatives) or ongoing projects (continuous collaboration).
Project Types:
- Single Projects: Clear-cut initiatives with defined start and finish, usually planned and billed as quoted
- Ongoing Projects: Continuous activities where tasks are handled and billed based on effort
Project Classification:
- External Projects: Billable customer projects that generate direct revenue
- Internal Projects: Non-billable activities essential for running the company (e.g., administration, product development)
Value Groups: Projects are classified by value creation:
- A - Direct value creation: External customer projects
- B - Indirect value creation: Internal projects that increase product/service value
- C - Not value creating: Administrative tasks
- D - Waste: Unproductive time (downtime, failed projects)
What is returned: The response includes project details such as name, short name (unique identifier), organization, category, status, phase, open tasks count, value group, type, tags, access permissions, and timestamps.
Retrieves a paginated grid of projects with filtering and sorting capabilities. Quick search available on: name, shortName, orgName. Filterable fields: id, name, shortName, type, valueGroup, categoryId, statusId, phaseId, deadline, organizationId, orgName, guestAccess, isFavorite, isArchived, openTasksCount, createdAt, editedAt. Sortable fields: id, name, shortName, type, valueGroup, categoryId, statusId, phaseId, deadline, organizationId, orgName, guestAccess, isFavorite, isArchived, openTasksCount, createdAt, editedAt.
/projectsAuthorizationOAuth2 access token · headerrequiredapi:readAuthorizationBearer token (JWT) · headerrequiredpagenumberpageSizenumberviewIdstringquickSearchstringfiltersstringsortstringfieldsToReturnany[]curl -X GET "https://leadtime.app/api/public/projects" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"const response = await fetch("https://leadtime.app/api/public/projects", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});import requests
response = requests.get(
"https://leadtime.app/api/public/projects",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
},
)