---
title: "List simulation suites"
method: GET
path: "/simulation_suites"
---

# List simulation suites

`GET /simulation_suites`

List simulation suites with pagination and optional filtering.

## Query parameters

- `page_number` integer
- `page_size` integer
- `search` string
- `model_ids` string[]
- `start_date` string, date-time
- `end_date` string, date-time

## Headers

- `Authorization` string, required

## Response `200`

200

- ListSimulationSuitesResponse200
  - `status` string — Whether the request was successful.
  - `response` PaginatedSimulationSuitesList
    - `items` SimulationSuiteListItem[], required — List of simulation suites
      - `id` string, uuid, required — Suite ID
      - `name` string, required — Name of the simulation suite
      - `model_id` string, required — Agent model ID this suite is for
      - `workspace_id` string, required — Workspace ID this suite belongs to
      - `language` string — Language locale for the persona agent and test cases (e.g., 'en-US', 'es-ES', 'fr-FR')
      - `created_at` string, date-time — When the suite was created
      - `updated_at` string, date-time — When the suite was last updated
      - `case_summaries` SimulationCaseSummary[] — Summary of cases in this suite
        - `simulation_case_id` string, uuid, required — Unique identifier for the simulation case
        - `name` string, required — Name of the simulation case
      - `agent` AgentListItem
        - `id` string, uuid
        - `name` string
        - `avatar` string, nullable
    - `total` integer, required — Total number of simulation suites
    - `page_number` integer, required — Current page number
    - `page_size` integer, required — Number of items per page

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/synthflow/apis/platform-api.md) · [All operations](https://skmtc.dev/synthflow/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/synthflow/platform-api/revisions/6976456ad422/schema)