---
search:
  tags:
    - projects
    - GET
seo:
  description: >-
    Returns a paginated, filterable list of projects visible to the
    authenticated user.… Reference for the GET /projects endpoint in the
    Leadtime Public API API.
sidebar:
  badge: GET
  label: List projects
title: List projects
type: openapi-operation
---
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.

<Operation source="api-reference" id="projectscontroller-listprojects" />