---
title: "List Bulk Actions"
method: GET
path: "/v2/workflows/bulkActions"
tags: ["Bulk Actions"]
---

# List Bulk Actions

`GET /v2/workflows/bulkActions`

## Request

- Base URL: `https://qstash-eu-central-1.upstash.io`
- URL: `https://qstash-eu-central-1.upstash.io/v2/workflows/bulkActions`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `qstash_token`
- TypeScript: <https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/docs/v2/workflows/bulkActions/get.ts> (a function with typed inputs; its response is checked against the schema)

List the bulk actions created by filter-based workflow run cancels

## Query parameters

- `cursor` string
- `count` integer
- `state` 'IN_PROGRESS' | 'FINISHED'

## Response `200`

List of bulk actions

- object
  - `bulkActions` BulkAction[]
    - `actionId` string: The ID of the bulk action.
    - `kind` 'cancel': The kind of the bulk action.
    - `state` 'IN_PROGRESS' | 'FINISHED': The state of the bulk action. |Value |Description| |-------|------------| | IN_PROGRESS |The bulk action is running in the background.| | FINISHED |The bulk action has finished.|
    - `total` integer: The number of in-progress workflow runs that matched the filter when the bulk action was created.
    - `processed` integer: The number of workflow runs processed by the bulk action so far.
    - `createdAt` integer: The creation time of the bulk action, in milliseconds (Unix timestamp).
    - `completedAt` integer: The completion time of the bulk action, in milliseconds (Unix timestamp). Only present once the bulk action has finished.
    - `filter` object: The filter the bulk action was created with. Keys are the filter parameter names of the bulk cancel request, such as `workflowUrl`, `label` or `fromDate`, and values are the given values.
  - `cursor` string: A cursor which you can use in subsequent requests to paginate through all bulk actions. If no cursor is returned, you have reached the end of the bulk actions.

## Other responses

- `400`: Invalid `count`, `cursor` or `state`

## Changes

- **2026-09-16** `99724af1d043`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/changes/v2/workflows/bulkActions/get.md)

---

[API](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api.md) - [All operations](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/revisions/251bee05a7ec?raw)