---
title: "List parameterized models for a cell specification or project"
method: GET
path: "/cells/{cell_spec_id}/parameterized_models"
tags: ["parameterized_models"]
---

# List parameterized models for a cell specification or project

`GET /cells/{cell_spec_id}/parameterized_models`

## Request

- Base URL: `https://api.ionworks.com`
- URL: `https://api.ionworks.com/cells/{cell_spec_id}/parameterized_models`
- Auth: none declared

List parameterized models with pagination, filtering, and sorting, scoped
by cell spec or project.

Provide exactly one scope:

- ``cell_spec_id`` lists models for a single cell specification. This is the
  path parameter when called via ``/cells/{cell_spec_id}/parameterized_models``.
- ``project_id`` lists models across every cell specification linked to the
  project. ``cell_spec_id`` may additionally be passed to narrow a
  project-scoped query to one cell specification.

Parameters
----------
model_id : str | None
    Base model to narrow to, matched exactly. Composes with either scope —
    e.g. every parameterized model in a project that derives from one model.
cell_spec_id : str | None
    Cell specification to scope to. Required when ``project_id`` is not given.
project_id : str | None
    Project to scope to. When set, ``cell_spec_id`` is an optional further
    filter rather than the primary scope.
name : str | None
    Column filter on the model name. Applies to both scopes. Values use
    Supabase operator syntax and are validated by the field policy — e.g.
    ``ilike.%alpha%`` for a case-insensitive substring match. A bare value
    falls through to an exact match.
description : str | None
    Column filter on the model description. Same operator-syntax semantics
    as ``name`` and likewise applies to both scopes.
q : str | None
    Free-text search on the model name plus a prefix full-text match,
    matching the global search. Applies to both scopes and composes with
    the ``name`` / ``description`` column filters.
order_by : {"name", "created_at"}
    Column to sort the cell-spec-scoped results by. Defaults to
    ``"created_at"``.
order : {"asc", "desc"}
    Sort direction for the cell-spec-scoped results. Defaults to ``"desc"``.
limit : int
    Maximum number of models to return per page (1-1000). Defaults to 100.
    The upper bound is 1000 so callers (e.g. the optimization clone form)
    can load every model for a project in one request.
offset : int
    Number of models to skip for pagination. Defaults to 0.
summary : bool
    Return summaries without the parameter values, which a full record
    inlines and which can run to hundreds of thousands of characters per
    model. Defaults to False.

## Path parameters

- `cell_spec_id` string, uuid, nullable, required

## Query parameters

- `project_id` string, uuid, nullable
- `name` string, nullable
- `description` string, nullable
- `model_id` string, nullable
- `created_at_gt` string, nullable
- `created_at_lt` string, nullable
- `order_by` 'name' | 'created_at'
- `order` 'asc' | 'desc'
- `limit` integer
- `offset` integer
- `q` string, nullable: Free-text search on parameterized model name.
- `summary` boolean: Return id, name, cell spec, base model and timestamps only, without the parameter values.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-24** `f4c74e855466`: 1 info
  - added the new optional `query` request parameter `summary`
- **2026-09-30** `ea3d377fec1a`: 2 breaking
  - for the `path` request parameter `cell_spec_id`, the format of property `anyOf[subschema #1]/` was specialized from no format to `uuid`
  - for the `query` request parameter `project_id`, the format of property `anyOf[subschema #1]/` was specialized from no format to `uuid`

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