---
title: "List all scenarios across all IVRs"
method: GET
path: "/scenarios"
tags: ["ivrs"]
---

# List all scenarios across all IVRs

`GET /scenarios`

Retrieves all scenarios across all IVRs in a single request. This is a convenience alternative to calling `GET /ivrs/{ivrId}/scenarios` for each IVR individually. Useful for building a global overview of all call flows configured in the team.

**Permission:** `IVRs Read` required.

**Monitoring impact:**
- **OFF:** Returns only scenarios from IVRs **assigned to you**.
- **ON:** Returns **all scenarios** across all team IVRs.

## Response `200`

Successful operation

- ScenarioList
  - `list_count` integer — The size of the list
  - `list` Scenario[]
    - `scenario_id` integer — The scenario identifier
    - `ivr_id` integer — The unique identifier of the IVR. Use `GET /ivrs` to discover available IVR IDs.
    - `name` string — The name of the scenario
    - `color` string
    - `scenario_type` 'menu' | 'announce' | 'queue' | 'sms' | 'webhook' | 'input' — The type of the scenario
    - `is_default` boolean

## Other responses

- `204` — No scenarios found
- `401` — Unauthorized — invalid API key or missing `IVRs Read` permission
- `500` — Internal server error

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)
