---
title: "List Optimization Runs"
method: GET
path: "/optimizations/{id}/runs"
tags: ["optimizations"]
---

# List Optimization Runs

`GET /optimizations/{id}/runs`

List the multistart runs of an optimization in one call.

Each run carries status and convergence history (read server-side),
so the frontend renders per-run progress without touching jobs.

## Path parameters

- `id` string, required

## Response `200`

Successful Response

- OptimizationRun[]
  - `run_id` string, required — Opaque identifier for this optimization run.
  - `index` integer, required — Zero-based position of the run.
  - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled', required — Frontend-facing lifecycle status for an async resource.
  - `intermediate_results` object[], nullable — Per-iteration convergence history for the run; its length is the current iteration count. Null until the run produces history.

## 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)