---
title: "List IVRs (Interactive Voice Response)"
method: GET
path: "/ivrs"
tags: ["ivrs"]
---

# List IVRs (Interactive Voice Response)

`GET /ivrs`

Retrieves all IVR (Interactive Voice Response) configurations for your team. An IVR defines an automated call flow — menu options, routing rules, welcome messages, business hours, and queue behavior. Each IVR has one or more scenarios (call flow variants). The total count is in the `list_count` field.

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

**Monitoring impact:**
- **OFF:** Returns only IVRs **assigned to you** (IVRs using your numbers).
- **ON:** Returns **all IVRs** in the team.

## Response `200`

Successful operation — returns the list of IVRs.

- IvrList
  - `list_count` integer — The size of the list
  - `list` IvrWithoutNumber[]
    - `ivr_id` integer — The identifier if the ivr
    - `color` 'ff6b6b' | 'F06292' | 'BA68C8' | '9575CD' | '7986CB' | '64B5F6' | '4FC3F7' | '4DD0E1' | '4DB6AC' | '81C784' | 'AED581' | 'DCE775' | 'FFD54F' | 'FFB74D' | 'FF8A65' | 'A1887F' | 'E0E0E0' | '90A4AE'
    - `name` string — The name of the ivr
    - `scenarios` object[]
      - `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
    - `is_open` boolean — The ivr is open or not

## Other responses

- `204` — No IVRs found.
- `401` — Unauthorized — invalid or missing API token, 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)