> 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 Simulations

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

Returns the simulations for the authenticated organization.

Reference: https://docs.vapi.ai/api-reference/simulations/simulation-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

- `idAny` (list of string, optional) — Return only simulations matching the provided ids
- `standaloneOnly` (boolean, optional) — Only include simulations that are not part of a suite
- `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 Simulation`

## Types

### Simulation

- `id` (string, required) — This is the unique identifier for the simulation.
- `orgId` (string, required) — This is the unique identifier for the organization this simulation belongs to.
- `createdAt` (datetime, required) — This is the ISO 8601 date-time string of when the simulation was created.
- `updatedAt` (datetime, required) — This is the ISO 8601 date-time string of when the simulation was last updated.
- `scenarioId` (string, required) — This is the ID of the scenario to use for this simulation.
- `personalityId` (string, required) — This is the ID of the personality to use for this simulation.
- `name` (string, optional) — This is an optional friendly name for the simulation.
- `path` (string, optional, nullable) — Optional folder path for organizing simulations. Supports up to 3 levels (e.g., "dept/feature/variant"). Maps to GitOps resource folder structure.

## Examples

**Response**

```json
[
  {
    "id": "string",
    "orgId": "string",
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-01-15T09:30:00Z",
    "scenarioId": "string",
    "personalityId": "string",
    "name": "Eligible Path with Confused User",
    "path": "string"
  }
]
```