---
title: "List simulation scenarios"
method: GET
path: "/v1/simulation/scenario"
tags: ["Simulation Scenario"]
---

# List simulation scenarios

`GET /v1/simulation/scenario`

Returns a paginated list of simulation scenarios for the authenticated project.

## Query parameters

- `limit` integer
- `after` string

## Response `200`

List of scenarios

- object
  - `data` object[], required
    - `id` string, uuid, required — Unique identifier of the scenario
    - `name` string, nullable, required — Name of the scenario (from the start node content)
    - `description` string, nullable, required — Description of the scenario
    - `steps` object[], required — Ordered list of steps in the scenario (excludes the START node)
      - `nodeId` string, uuid, required — Unique identifier of the step node (use this for update/delete operations)
      - `type` 'START' | 'AGENT_TURN' | 'CUSTOMER_TURN' | 'CUSTOMER_FIRST_MESSAGE' | 'CUSTOMER_SILENCE' | 'CUSTOMER_DTMF' | 'VOICEMAIL' | 'SCENARIO_LINK', required — Type of step in the scenario
      - `content` string, nullable, required — Content/text of the step
      - `linkedScenarioId` string, uuid, nullable — ID of the linked scenario (only for SCENARIO_LINK type steps)
      - `dtmfDigits` string, nullable — DTMF digits to send during this step (e.g. 1w2w3#). Valid characters: 0-9, *, #, w/W for pauses.
      - `silenceDurationSeconds` integer, nullable — Duration of silence in seconds (only for CUSTOMER_SILENCE type steps)
    - `createdAt` string, required — Creation timestamp in ISO 8601 format
    - `updatedAt` string, required — Last update timestamp in ISO 8601 format
  - `pagination` object, required
    - `total` number, required — Total number of items
    - `hasMore` boolean, required — Whether there are more items to fetch
    - `nextCursor` string, nullable, required — Cursor for the next page of items

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/roarkhq/apis/roark-analytics-api.md) · [All operations](https://skmtc.net/roarkhq/apis/roark-analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/roarkhq/roark-analytics-api/revisions/83528d3618ef/schema)