---
title: "Get a parameterized model by id"
method: GET
path: "/parameterized_models/{parameterized_model_id}"
tags: ["parameterized_models"]
---

# Get a parameterized model by id

`GET /parameterized_models/{parameterized_model_id}`

## Request

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

Get a single parameterized model (with its model info) by id.

Lets clients fetch one model directly instead of listing every model
in a project. Access is scoped by row-level security via the
requesting user's client.

## Path parameters

- `parameterized_model_id` string, uuid, required

## Response `200`

Successful Response

- ParameterizedModelWithLinks
  - `url` string, nullable
  - `api_url` string, nullable
  - `model` object, required: Model info with id and name (loaded from models table via join).
  - `parameters` object, required: Model parameters.
  - `simulation_settings` object, nullable: Optional parameter-specific simulation kwargs.
  - `id` string, required: Unique identifier for the parameterized model.
  - `name` string, required: Human-readable name of the parameterized model.
  - `description` string, nullable: Optional description of the parameterized model.
  - `cell_spec_id` string, nullable: Associated cell specification ID.
  - `project_id` string, required: Owning project ID, denormalized from the cell specification for models that have one, and supplied directly by the caller for quick models that do not.
  - `organization_id` string, required: Owning organization ID.
  - `created_at` string, date-time, nullable: When the parameterized model was created.
  - `updated_at` string, date-time, nullable: When the parameterized model was last updated.
  - `created_by` string, nullable: User ID of the creator.
  - `source_model_builder_id` string, nullable: Model builder that produced these parameters.
  - `build_provenance` object, nullable: Builder config snapshot and resolved cell-spec hash it ran on.
  - `parameter_symbols` object, nullable: Display symbols overriding the defaults, by parameter name.

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `abebbbc5f60a`: 1 info
  - added the optional property `parameter_symbols` to the response with the `200` status
- **2026-10-28** `3abf50e2d741`: 1 breaking, 16 info
  - the response's body type changed from no type to `object` for status `200`
  - added the optional property `api_url` to the response with the `200` status
  - added the optional property `build_provenance` to the response with the `200` status
  - added the optional property `cell_spec_id` to the response with the `200` status
  - …13 more
- **2026-09-30** `ea3d377fec1a`: 1 breaking
  - for the `path` request parameter `parameterized_model_id`, the format changed from no format to `uuid`

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