Simulations

List Simulations

List simulations filtered by a parameterized model, study, or protocol.

Exactly one of parameterized_model_id, study_id, or experiment_template_id must be provided. Returns simulation summaries without simulation_data, plus a map of model scalar parameters deduplicated by parameterized_model_id.

Parameters

parameterized_model_id : str, optional Filter simulations belonging to this parameterized model. study_id : str, optional Filter simulations assigned to this study. experiment_template_id : str, optional Filter simulations whose experiment references this protocol template. limit : int, optional Maximum number of results to return. Must be between 1 and 1000. Defaults to 100. offset : int, optional Number of results to skip for pagination. Must be >= 0. Defaults to 0. status : str, optional PostgREST filter expression on the simulation's job status, e.g. "eq.completed" or "in.(pending,processing,waiting)". When provided, only simulations whose job matches are returned. model_name, protocol_name : str, optional Exact-match expressions (e.g. "eq.My model") on the joined parameterized model name and protocol (experiment template) name. A simulation has no name of its own, so these two are what identify it. created_at_gt, created_at_lt, updated_at_gt, updated_at_lt : str, optional ISO datetime strings for date-range (between) filtering on the native created_at / updated_at columns.

Returns

ListSimulationsResponse Simulations, model scalar parameters map, and total count.

get/simulations

Query parameters

parameterized_model_idstring nullable
study_idstring nullable
experiment_template_idstring nullable
limitinteger
offsetinteger
statusstring nullable
model_namestring nullable
protocol_namestring nullable
created_at_gtstring nullable
created_at_ltstring nullable
updated_at_gtstring nullable
updated_at_ltstring nullable

Response

Successful Response

model_scalar_parametersobject

Map of parameterized_model_id to scalar-only parameters. Used as fallback when design.design_parameters doesn't have a value.

totalinteger

Total number of matching simulations.

Changes

No recorded changes to this endpoint across all 1 revision of this API.