---
title: "Get Validation Plot Data"
method: GET
path: "/pipelines/validations/{job_id}/plot_data"
tags: ["Pipeline"]
---

# Get Validation Plot Data

`GET /pipelines/validations/{job_id}/plot_data`

Return decimated trace data for a single validation or data-fit plot.

Reads the stored ``validation_plot_config`` from the job's metadata blob,
extracts the requested plot, filters to the given x-range, and downsamples
to at most ``max_points`` per trace. Supports semantic zoom: callers refetch
with ``x_min``/``x_max`` set to the current viewport on each zoom event.

``max_points`` is a per-trace ceiling, and a figure may hold several traces, so it
is reduced where the whole response would otherwise exceed the payload cap — see
``src.jobs.plot_data._payload_capped_budget``.

## Path parameters

- `job_id` string, required

## Query parameters

- `objective_name` string, required — Objective name within validation_plot_config
- `plot_index` integer — Index into the plots list for this objective
- `max_points` integer — Maximum points per trace
- `x_min` number, nullable — Lower x-range bound (inclusive)
- `x_max` number, nullable — Upper x-range bound (inclusive)

## Response `200`

Successful Response

- ValidationPlotDataResponse — Response from GET /pipelines/{validations|datafits}/{job_id}/plot_data. Contains decimated trace data for a single validation plot, filtered to the requested x-range and downsampled to at most ``max_points`` per trace.
  - `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

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ionworks/apis/fastapi.md) · [All operations](https://skmtc.dev/ionworks/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ionworks/fastapi/revisions/7337a3cbdaf2/schema)