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

# Get Optimization Resource

`GET /optimizations/{id}`

## Request

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

Get a single optimization as a job-free resource.

Accepts an optimization id (or, transitionally, a job_id) and returns
an :class:`OptimizationResource` with flat status and run count.

## Path parameters

- `id` string, uuid, required

## Response `200`

Successful Response

- OptimizationResourceWithLinks
  - `url` string, nullable
  - `api_url` string, nullable
  - `id` string, required: Canonical optimization identifier.
  - `name` string, nullable
  - `description` string, nullable
  - `project_id` string, required
  - `organization_id` string, required
  - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled': Frontend-facing lifecycle status for an async resource.
  - `kind` string, nullable: Optimization kind discriminator (e.g. 'optimize', 'datafit'); determines how the config is interpreted.
  - `created_at` string, date-time, nullable
  - `created_by_email` string, nullable
  - `cell_spec_id` string, nullable
  - `parameterized_model_id` string, nullable
  - `parameterized_model_name` string, nullable: Display name of the parameterized model.
  - `cell_name` string, nullable: Display name of the cell specification.
  - `optimization_template_id` string, nullable
  - `metrics` object, nullable: Result metrics of the optimization, when complete.
  - `objectives` object, nullable: Objectives/constraints from the config, for list display. Populated on list responses only.
  - `error` string, nullable: Error message if the run failed.
  - `error_code` string, nullable: Machine-readable error code.
  - `run_count` integer: Number of multistart runs.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-28** `3abf50e2d741`: 2 info
  - added the optional property `api_url` to the response with the `200` status
  - added the optional property `url` to the response with the `200` status
- **2026-09-30** `ea3d377fec1a`: 1 breaking
  - for the `path` request parameter `id`, the format changed from no format to `uuid`

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