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

# List parameterized models for a cell specification or project

`GET /parameterized_models`

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.

## Query parameters

- `cell_spec_id` string, nullable
- `project_id` string, 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.

## Response `200`

Successful Response

- unknown

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