---
search:
  tags:
    - projects
    - GET
seo:
  description: >-
    Returns a list of all saved project versions (snapshots) with their…
    Reference for the GET /projects/{id}/versions endpoint in the Leadtime
    Public API API.
sidebar:
  badge: GET
  label: List all versions for a project
title: List all versions for a project
type: openapi-operation
---
Returns a list of all saved project versions (snapshots) with their details.

**What are Project Versions?**
Project versions freeze the current state of a project configuration at a specific point in time. They capture the complete project state including:
- Project tree structure with dynamically activated work packages
- Products including variants, prices, and discounts
- Answered form questions and their effects
- Manually added items
- All configuration changes

Versions ensure that offered, negotiated, and contracted content remains traceable. They serve as the basis for quotes, specifications, and billing documents.

**What is returned:**
- **id**: Unique version identifier (UUID)
- **title**: Version title/name
- **semverVersion**: Semantic version string (e.g., "1.2.3")
- **branchId**: Branch identifier for version tracking
- **parentId**: Parent version ID (null for first version)
- **createdAt**: ISO 8601 timestamp when version was created
- **createdBy**: User ID who created the version
- **description**: HTML-formatted version description
- **isCurrent**: Whether this is the current active version for the project

**Use cases:**
- View version history to see how project evolved
- Select a version when creating quotes or specifications
- Compare different project states
- Restore to a previous version if needed

<Operation source="api-reference" id="projectversionscontroller-listversions" />