---
title: "List Actions"
method: GET
path: "/v1/actions/list"
tags: ["actions"]
---

# List Actions

`GET /v1/actions/list`

## Query parameters

- `page` integer
- `size` integer
- `sort_column` string, nullable
- `sort_desc` boolean, nullable

## Response `200`

Successful Response

- ActionPage
  - `items` union[], required
    - union
      - TransferCallAction
        - `id` string, uuid, required
        - `user_id` string, uuid, required
        - `type` 'action_transfer_call', required
        - `config` TransferCallConfig, required
          - `phone_number` string, required
        - `action_trigger` union
          - FunctionCallActionTrigger
            - `type` 'action_trigger_function_call', required
            - `config` FunctionCallActionTriggerConfig
          - PhraseBasedActionTriggerOutput
            - `type` 'action_trigger_phrase_based', required
            - `config` PhraseBasedActionTriggerConfig, required
              - …
      - EndConversationAction
        - `id` string, uuid, required
        - `user_id` string, uuid, required
        - `type` 'action_end_conversation', required
        - `config` EmptyActionConfig
        - `action_trigger` union
          - FunctionCallActionTrigger
            - `type` 'action_trigger_function_call', required
            - `config` FunctionCallActionTriggerConfig
          - PhraseBasedActionTriggerOutput
            - `type` 'action_trigger_phrase_based', required
            - `config` PhraseBasedActionTriggerConfig, required
              - …
      - DTMFAction
        - `id` string, uuid, required
        - `user_id` string, uuid, required
        - `type` 'action_dtmf', required
        - `config` EmptyActionConfig
        - `action_trigger` FunctionCallActionTrigger
          - `type` 'action_trigger_function_call', required
          - `config` FunctionCallActionTriggerConfig
      - AddToConferenceAction
        - `id` string, uuid, required
        - `user_id` string, uuid, required
        - `type` 'action_add_to_conference', required
        - `config` AddToConferenceConfig, required
          - `phone_number` string, required
          - `place_primary_on_hold` boolean
        - `action_trigger` union
          - FunctionCallActionTrigger
            - `type` 'action_trigger_function_call', required
            - `config` FunctionCallActionTriggerConfig
          - PhraseBasedActionTriggerOutput
            - `type` 'action_trigger_phrase_based', required
            - `config` PhraseBasedActionTriggerConfig, required
              - …
      - SetHoldAction
        - `id` string, uuid, required
        - `user_id` string, uuid, required
        - `type` 'action_set_hold', required
        - `config` EmptyActionConfig
        - `action_trigger` union
          - FunctionCallActionTrigger
            - `type` 'action_trigger_function_call', required
            - `config` FunctionCallActionTriggerConfig
          - PhraseBasedActionTriggerOutput
            - `type` 'action_trigger_phrase_based', required
            - `config` PhraseBasedActionTriggerConfig, required
              - …
      - ExternalAction
        - `id` string, uuid, required
        - `user_id` string, uuid, required
        - `type` 'action_external', required
        - `config` ExternalActionConfig, required
          - `processing_mode` 'muted'
          - `name` string, required
          - `description` string, required
          - `url` string, required
          - `input_schema` object, required
          - `speak_on_send` boolean, required
          - `speak_on_receive` boolean, required
          - `signature_secret` string
        - `action_trigger` FunctionCallActionTrigger
          - `type` 'action_trigger_function_call', required
          - `config` FunctionCallActionTriggerConfig
  - `page` integer, required
  - `size` integer, required
  - `has_more` boolean, required
  - `total` integer, required
  - `total_is_estimated` boolean, required

## Other responses

- `422` — Validation Error

## Changes

- **2024-08-14** `63991d99e2e1` — 4 breaking, 30 info
  - added `#/components/schemas/PhraseBasedActionTrigger-Output` to the `items/items/oneOf[subschema #1: TransferCallAction]/action_trigger` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PhraseBasedActionTrigger-Output` to the `items/items/oneOf[subschema #2: EndConversationAction]/action_trigger` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PhraseBasedActionTrigger-Output` to the `items/items/oneOf[subschema #4: AddToConferenceAction]/action_trigger` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PhraseBasedActionTrigger-Output` to the `items/items/oneOf[subschema #5: SetHoldAction]/action_trigger` response property `oneOf` list for the response status `200`
  - …30 more
- **2024-04-19** `55ae0e0bb01f` — 2 info
  - added the required property `total` to the response with the `200` status
  - added the required property `total_is_estimated` to the response with the `200` status
- **2024-04-15** `47ab17602d64` — 1 breaking, 1 info
  - added `#/components/schemas/ExternalAction` to the `items/items/` response property `oneOf` list for the response status `200`
  - added `action_external` discriminator mapping keys to the `items/items/` response property for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/changes/v1/actions/list/get.md)

---

[API](https://skmtc.dev/vocodedev/apis/vocode-hosted-api.md) · [All operations](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vocodedev/vocode-hosted-api/revisions/ffca17c004e2/schema)