---
title: "List Optimization Templates"
method: GET
path: "/optimization_templates"
tags: ["optimization_templates"]
---

# List Optimization Templates

`GET /optimization_templates`

List all optimization templates accessible from the given project.

Returns the project's own templates combined with system-level templates.

Parameters
----------
project_id : str
    The owner project whose templates should be retrieved.
q : str | None, optional
    Free-text search on template name plus prefix full-text match, matching
    the global search. Pushed into each source query (project + system) as a
    SQL filter before the in-memory merge, rather than a Python substring.
created_at_gt, created_at_lt, updated_at_gt, updated_at_lt : str | None, optional
    ISO datetime strings for date-range (between) filtering on the
    ``created_at`` / ``updated_at`` columns.

Returns
-------
list[OptimizationTemplate]
    Owned templates followed by system templates.

## Query parameters

- `project_id` string, required
- `q` string, nullable — Free-text search on template name plus prefix full-text match, matching the global search.
- `created_at_gt` string, nullable
- `created_at_lt` string, nullable
- `updated_at_gt` string, nullable
- `updated_at_lt` string, nullable

## Response `200`

Successful Response

- OptimizationTemplate[]
  - `name` string, required — The name of the optimization template.
  - `description` string, nullable — An optional description for the template.
  - `initial_form_data` object, nullable — Initial form data values.
  - `id` string, required — The unique identifier for the template.
  - `organization_id` string, required — The ID of the organization this template belongs to.
  - `project_id` string, nullable — The ID of the owner project (None for system templates).
  - `access_level` string — Template scope: 'system' for built-in, 'project' for user-created.
  - `created_at` string, date-time, required — Timestamp of when the template was created.
  - `updated_at` string, date-time, required — Timestamp of when the template was last updated.
  - `created_by` string, nullable — User ID of the creator.

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