---
title: "Get Optimization Series"
method: GET
path: "/optimizations/{id}/series"
tags: ["optimizations"]
---

# Get Optimization Series

`GET /optimizations/{id}/series`

## Request

- Base URL: `https://api.ionworks.com`
- URL: `https://api.ionworks.com/optimizations/{id}/series`
- Auth: none declared

One objective's validation series, windowed and budgeted.

The same rows ``/metadata`` carries whole. A plot reading them from there downloads every
sample of both solves to draw a few hundred points.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `objective` string, required: Objective name within the payload
- `source` string: Which solve: 'optimal' or 'baseline'
- `columns` string, nullable: Comma-separated channels besides the x column
- `x_column` string, nullable: Column plotted on x, and windowed on. Defaults to the objective's own x channel, which is not 'Time [s]' for every objective type.
- `x` string, nullable: Deprecated alias for ``x_column``, kept for one release. ``x_column`` wins when both are given.
- `max_points` integer, nullable: Row ceiling, from the plot's measured width
- `x_min` number, nullable: Window lower bound, in x's units
- `x_max` number, nullable: Window upper bound, in x's units

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-30** `ea3d377fec1a`: 1 breaking
  - for the `path` request parameter `id`, the format changed from no format to `uuid`
- **2026-09-09** `48c041ad4800`: 1 breaking, 4 info
  - for the `query` request parameter `x`, default value `Time [s]` was removed
  - added the new optional `query` request parameter `x_column`
  - `query` request parameter `x` was deprecated
  - `query` request parameter `x` list-of-types was widened by adding types `null`
  - …1 more

[Operation history](https://skmtc.dev/ionworks/apis/ionworks-api/changes/optimizations/:id/series/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)