Get version details

Returns complete details for a specific project version, including estimate data.

What is returned:

All standard version fields (id, title, semverVersion, branchId, parentId, createdAt, createdBy, description, isCurrent)
estimateData: Complete estimate data including:
- Products with variants, prices, and discounts
- Components with nested structure
- Manual positions
- Pricing breakdowns (fixed, subscriptions, per-unit)

Use cases:

View detailed version information
Access estimate data for a specific version
Compare estimate data between versions
Use version data for generating documents or reports

GET/projects/{id}/versions/{versionId}

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstringrequired

versionIdstringrequired

Responses

200

Version details with estimate data

branchIdstringrequired

Branch identifier (UUID) for version tracking. Used to group related versions together and enable branching/versioning workflows

createdAtstringrequired

ISO 8601 timestamp when the version was created

createdBystringrequired

User ID (UUID) who created the version

descriptionstringrequired

HTML-formatted description of the version. Originally provided as HTML or Markdown when creating the version, always returned as HTML

estimateDataobjectrequired

Complete estimate data captured at the time the version was created. Includes products with variants and prices, components with nested structure, manual positions, and pricing breakdowns (fixed, subscriptions, per-unit). This data represents the exact project state when the version was saved.

idstringrequired

Unique identifier of the version (UUID)

isCurrentbooleanrequired

Whether this is the current active version for the project. Only one version can be current at a time. The current version represents the active project state

parentIdobject | nullrequired

Parent version ID (UUID). Null if this is the first version created for the project. Used to track version lineage and generate semantic version numbers

semverVersionstringrequired

Semantic version string automatically generated based on parent version and branch. Follows semver-like format (e.g., "1.2.3")

titlestringrequired

Title/name of the version as provided when creating it

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

404

Version or project not found

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

idpath*versionIdpath*

Request

curl -X GET "https://leadtime.app/api/public/projects/string/versions/string" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/projects/string/versions/string", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/projects/string/versions/string",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

{
  "branchId": "770e8400-e29b-41d4-a716-446655440002",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "createdBy": "880e8400-e29b-41d4-a716-446655440003",
  "description": "<h1>Version Description</h1><p>This is version 1.2.3</p>",
  "estimateData": {},
  "id": "660e8400-e29b-41d4-a716-446655440001",
  "isCurrent": true,
  "parentId": "660e8400-e29b-41d4-a716-446655440000",
  "semverVersion": "1.2.3",
  "title": "Version 1.2.3"
}