---
title: "List simulation cases by agent"
method: GET
path: "/simulation_cases/by_agent"
tags: [""]
---

# List simulation cases by agent

`GET /simulation_cases/by_agent`

List all simulation cases created for a specific agent.

## Query parameters

- `agent_id` string, required

## Headers

- `Authorization` string, required

## Response `200`

200

- ListSimulationCasesByAgentResponse200
  - `status` string — Whether the request was successful.
  - `response` SimulationCaseReadOut[]
    - `simulation_case_id` string, uuid
    - `workspace_id` string
    - `suite_id` string, uuid, nullable — ID of the simulation suite this case belongs to.
    - `name` string
    - `prompt` string
    - `type` 'custom' | 'agent_based'
    - `success_criteria` string[]
    - `call_success_type` 'all' | 'any'
    - `base_agent` SimulationCaseReadOutBaseAgent
      - `model_id` string
      - `agent_name` string
      - `agent_type` string
      - `voice_engine_type` string
      - `phone_number` string, nullable
      - `updated_at` string, date-time
      - `image_url` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `400` — 400

---

[API](https://skmtc.net/synthflow/apis/platform-api.md) · [All operations](https://skmtc.net/synthflow/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synthflow/platform-api/versions/decb652b52e0/schema)