---
title: "List the measurements a pipeline ran against"
method: GET
path: "/pipelines/{pipeline_id}/measurements"
tags: ["Pipeline"]
---

# List the measurements a pipeline ran against

`GET /pipelines/{pipeline_id}/measurements`

What each element read, and over what window.

A measurement can be extended or superseded after a run, so the window is
what says which data a result was computed from. Each entry carries the
measurement's current span alongside, so a caller can tell at a glance
when it has outgrown the window the run used.

Empty means the pipeline read no stored measurement: new pipelines record
what they read at create, and the backfill covers every older one.

## Path parameters

- `pipeline_id` string, required

## Response `200`

Successful Response

- PipelineMeasurementUse[]
  - `measurement_id` string, required — The measurement the element's config named.
  - `measurement_name` string — Its name; the recorded snapshot when it is deleted.
  - `element_id` string, required — The element that read it.
  - `element_name` string — That element's name.
  - `element_order` integer — Its 1-based position in the pipeline.
  - `time_range_start` number, nullable — Inclusive lower bound of the window used, in seconds.
  - `time_range_end` number, nullable — Inclusive upper bound of the window used, in seconds.
  - `current_duration_s` number, nullable — Seconds the measurement's data covers now.
  - `measurement_deleted` boolean, nullable — True when deleted, false when visible, and null when the caller cannot distinguish deletion from lack of measurement access.

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-26** `8ed5440390f0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ionworks/apis/fastapi/changes/pipelines/:pipeline_id/measurements/get.md)

---

[API](https://skmtc.dev/ionworks/apis/fastapi.md) · [All operations](https://skmtc.dev/ionworks/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/ionworks/apis/fastapi/revisions/8ed5440390f0?raw)