---
title: "Get pipeline stage tree"
method: GET
path: "/tree"
tags: ["Pipeline Overview"]
---

# Get pipeline stage tree

`GET /tree`

Returns the complete stage tree structure for the pipeline run, including all stages,
their states, timing information, and hierarchy.

## Response `200`

Pipeline tree structure

- PipelineTreeResponse
  - `status` 'ok'
  - `data` PipelineGraph
    - `complete` boolean — Whether the pipeline run is complete
    - `stages` PipelineStage[]
      - `id` string — Unique identifier for the stage
      - `name` string — Display name of the stage
      - `state` 'queued' | 'running' | 'paused' | 'skipped' | 'not_built' | 'finished' | 'success' | 'unstable' | 'failure' | 'unknown' | 'aborted'
      - `type` string — Type of the stage (e.g., "STAGE", "PARALLEL")
      - `title` string — Full title/description of the stage
      - `pauseDurationMillis` integer — Duration in milliseconds the stage was paused
      - `startTimeMillis` integer — Stage start time in milliseconds since epoch
      - `totalDurationMillis` unknown
      - `children` PipelineStage[] — Child stages (for parallel or nested stages)
      - `seqContainerName` unknown
      - `nextSibling` PipelineStage — recursive
      - `isSequential` boolean — Whether this stage is sequential
      - `synthetic` boolean — Whether this is a synthetic stage
      - `placeholder` boolean — Whether this is a placeholder stage
      - `agent` unknown
      - `causeOfBlockage` unknown
      - `url` string — URL to view this stage in the UI

## Other responses

- `500` — Internal server error

## Changes

- **2026-07-17** `c1a45dd913f0` — 1 info
  - added the optional property `data/stages/items/causeOfBlockage` to the response with the `200` status
- **2025-08-20** `bfd131300cca` — 1 warning
  - removed the optional property `data/stages/items/causeOfBlockage` from the response with the `200` status

[Change history](https://skmtc.dev/jenkinsci/apis/jenkins-pipeline-graph-view-plugin-api/changes/tree/get.md)

---

[API](https://skmtc.dev/jenkinsci/apis/jenkins-pipeline-graph-view-plugin-api.md) · [All operations](https://skmtc.dev/jenkinsci/apis/jenkins-pipeline-graph-view-plugin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jenkinsci/jenkins-pipeline-graph-view-plugin-api/revisions/c1a45dd913f0/schema)