---
search:
  tags:
    - projects
    - GET
seo:
  description: >-
    Returns the complete hierarchical tree structure of… Reference for the GET
    /projects/{projectId}/components/tree endpoint in the Leadtime Public API
    API.
sidebar:
  badge: GET
  label: Get component tree for a specific project
title: Get component tree for a specific project
type: openapi-operation
---
Returns the complete hierarchical tree structure of components and their items for a specific project. Only non-deleted components and items are included in the response.

**Component Tree Structure:**
The project tree organizes work into a clear hierarchy:
- **Components**: Top-level containers that group related work packages. Examples include "Website Development", "CRM Onboarding", or "E-commerce Setup". Each component represents a major deliverable or project phase.
- **Items**: Building blocks within components. Each item can be one of four types:
  - **Epic**: Major sections or phases that group related work packages around a common theme (e.g., "Technical Implementation", "Design & Development")
  - **Work Package**: Self-contained, clearly defined tasks that deliver tangible results (e.g., "Set up hosting", "Design homepage layout"). Work packages can have timeframes, questions, todos, and test cases.
  - **Todo List**: Checklists of sub-steps or checkpoints perfect for recurring processes, quality control, or project preparation (e.g., "Kickoff Checklist", "Quality Control")
  - **Test Suite**: Formal acceptance tests for project results. Contains multiple test cases with steps and expected results (e.g., "Contact Form Tests", "SEO Review")

**Nesting and Relationships:**
Items can be nested to any depth, allowing for complex project structures. Each Work Package can contain Questions (to capture customer requirements), Todos (checklist items that can be checked off), and Test Cases (individual test steps within a Test Suite).

**Use Cases:**
This endpoint is ideal for displaying the complete project structure in a tree view, understanding project organization, and navigating the component hierarchy.

<Operation source="api-reference" id="projectcomponentscontroller-getprojecttree" />
