---
title: "List action urls"
method: GET
path: "/ivrs/{id}/action_urls"
tags: ["Virtual Receptionist"]
---

# List action urls

`GET /ivrs/{id}/action_urls`

## Request

- Base URL: `https://HOSTNAME:8887/api`
- URL: `https://HOSTNAME:8887/api/ivrs/{id}/action_urls`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/portsip/apis/portsip-pbx-rest-api/docs/ivrs/:id/action_urls/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of action urls of virtual receptionist.

## Path parameters

- `id` string, required: The unique ID of the resource.

## Response `200`

OK

- object
  - `items` object[]
    - `id` string: The unique ID of the resource.
    - `name` string: The name of action url.
    - `enabled` boolean: Enabled this event or not.
    - `type` 'DTMF' | 'CALLER': The action url type. Can be either: - `DTMF`: - `CALLER`
    - `caller_mask` string: The caller mask of action url.
    - `dtmf_mask` string: The DTMF mask of action url. A semicolon-separated list of DTMF number or DTMF number range. For example: 1000;2000;3000-4000.
    - `method` 'GET' | 'POST': The action url request method. Can be either: - `GET` - `POST`:
    - `headers` string: The request headers of action url.
    - `connection_timeout` integer: The connection timeout in seconds.
    - `request_timeout` integer: The request timeout in seconds.
    - `auth` 'DISABLE' | 'BASIC' | 'DIGEST' | 'BEARER': The authentication method of event URL: Can be either: - `DISABLE`: Disable authentication. - `BASIC`: Use basic authentication. - `DIGEST`: Use digest authentication. - `BEARER`: Use bearer authentication.
    - `username` string: The username for authentication, when auth is `BASIC` or `DIGEST`.
    - `password` string: The password for authentication, when auth is `BASIC` or `DIGEST`.
    - `token` string: The token for authentication, when auth is `BEARER`.
    - `url` string: The event url.

## Other responses

- `4XX`: Error

---

[API](https://skmtc.dev/portsip/apis/portsip-pbx-rest-api.md) - [All operations](https://skmtc.dev/portsip/apis/portsip-pbx-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/portsip/apis/portsip-pbx-rest-api/revisions/577415d4a3d5?raw)