---
title: "Get Pipeline Element Plot Data Batch"
method: GET
path: "/pipelines/elements/{element_id}/plot_data_batch"
tags: ["Pipeline"]
---

# Get Pipeline Element Plot Data Batch

`GET /pipelines/elements/{element_id}/plot_data_batch`

## Request

- Base URL: `https://api.ionworks.com`
- URL: `https://api.ionworks.com/pipelines/elements/{element_id}/plot_data_batch`
- Auth: none declared

Return every validation plot of an element at full extent, in one response.

What the first paint of a validation section needs: one request for all objectives
rather than two per objective. Each plot is decimated to at most ``max_points`` per
trace, lowered evenly across the batch where the whole body would otherwise exceed
the batch payload cap; the served budget is returned as ``max_points`` and each plot
reports whether it is ``complete`` at that budget. Zoom into one plot through
``GET /pipelines/elements/{element_id}/plot_data``.

## Path parameters

- `element_id` string, uuid, required

## Query parameters

- `max_points` integer: Maximum points per trace

## Response `200`

Successful Response

- ValidationPlotDataBatchResponse: Response from GET /pipelines/elements/{element_id}/plot_data_batch. Every plot of every objective in one body, so the first paint of a validation section is one request rather than two per objective.
  - `max_points` integer, required
  - `plots` ValidationPlotDataBatchEntry[], required
    - `type` string, nullable
    - `traces` ValidationPlotTrace[], required
      - `name` string, required
      - `x` number[], required
      - `y` number[], required
    - `x_full_min` number, nullable
    - `x_full_max` number, nullable
    - `layout` object, required
    - `objective_name` string, required
    - `plot_index` integer, required
    - `complete` boolean, required
    - `window_rows` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-30** `ea3d377fec1a`: 1 breaking
  - for the `path` request parameter `element_id`, the format changed from no format to `uuid`
- **2026-09-26** `8ed5440390f0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ionworks/apis/ionworks-api/changes/pipelines/elements/:element_id/plot_data_batch/get.md)

---

[API](https://skmtc.dev/ionworks/apis/ionworks-api.md) - [All operations](https://skmtc.dev/ionworks/apis/ionworks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ionworks/apis/ionworks-api/revisions/abebbbc5f60a?raw)