> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.vapi.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.vapi.ai/_mcp/server.

# List Simulation Suites

GET https://api.vapi.ai/eval/simulation/suite

Returns the simulation suites for the authenticated organization.

Reference: https://docs.vapi.ai/api-reference/simulation-suites/simulation-suite-controller-find-all

## Authentication

- `Authorization` header (bearer token, required) — Authenticate server-side requests with a private Vapi API key. Create or copy a key from the [Vapi Dashboard](https://dashboard.vapi.ai) and send it in the `Authorization` header as `Bearer <token>`. Keep private API keys out of client-side code and public repositories.

## Request

### Query parameters

- `name` (string, optional) — Search by simulation suite name
- `page` (double, optional) — This is the page number to return. Defaults to 1.
- `sortOrder` (enum, optional) — This is the sort order for pagination. Defaults to 'DESC'.
  - Allowed values: `ASC`, `DESC`
- `sortBy` (enum, optional) — This is the column to sort by. Defaults to 'createdAt'.
  - Allowed values: `createdAt`, `duration`, `cost`
- `limit` (double, optional) — This is the maximum number of items to return. Defaults to 100.
- `createdAtGt` (datetime, optional) — This will return items where the createdAt is greater than the specified value.
- `createdAtLt` (datetime, optional) — This will return items where the createdAt is less than the specified value.
- `createdAtGe` (datetime, optional) — This will return items where the createdAt is greater than or equal to the specified value.
- `createdAtLe` (datetime, optional) — This will return items where the createdAt is less than or equal to the specified value.
- `updatedAtGt` (datetime, optional) — This will return items where the updatedAt is greater than the specified value.
- `updatedAtLt` (datetime, optional) — This will return items where the updatedAt is less than the specified value.
- `updatedAtGe` (datetime, optional) — This will return items where the updatedAt is greater than or equal to the specified value.
- `updatedAtLe` (datetime, optional) — This will return items where the updatedAt is less than or equal to the specified value.

## Response

### 200

- `list of SimulationSuite`

## Types

### SimulationSuite

- `id` (string, required) — This is the unique identifier for the simulation suite.
- `orgId` (string, required) — This is the unique identifier for the organization this suite belongs to.
- `createdAt` (datetime, required) — This is the ISO 8601 date-time string of when the suite was created.
- `updatedAt` (datetime, required) — This is the ISO 8601 date-time string of when the suite was last updated.
- `name` (string, required) — This is the name of the simulation suite.
- `simulationIds` (list of string, required) — This is the list of simulation IDs in this suite.
- `targetAssignments` (list of SimulationSuiteTargetAssignment, required) — This is the ordered list of assistant or squad assignments for the suite.
- `slackWebhookUrl` (string, optional) — This is the Slack webhook URL for notifications.
- `path` (string, optional, nullable) — Optional folder path for organizing simulation suites. Supports up to 3 levels (e.g., "dept/feature/variant"). Maps to GitOps resource folder structure.

### SimulationSuiteTargetAssignment

- `targetType` (enum, required) — This is the type of target assigned to the simulation suite.
  - Allowed values: `assistant`, `squad`
- `targetId` (string, required) — This is the unique identifier of the assigned assistant or squad.

## Examples

**Response**

```json
[
  {
    "id": "string",
    "orgId": "string",
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-01-15T09:30:00Z",
    "name": "Checkout Flow Tests",
    "simulationIds": [
      "string"
    ],
    "targetAssignments": [
      {
        "targetType": "assistant",
        "targetId": "string"
      }
    ],
    "slackWebhookUrl": "string",
    "path": "string"
  }
]
```