---
title: "Get a Bulk Action"
method: GET
path: "/v2/workflows/bulkActions/{actionId}"
tags: ["Bulk Actions"]
---

# Get a Bulk Action

`GET /v2/workflows/bulkActions/{actionId}`

## Request

- Base URL: `https://qstash-eu-central-1.upstash.io`
- URL: `https://qstash-eu-central-1.upstash.io/v2/workflows/bulkActions/{actionId}`
- 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/:actionId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the details and progress of a bulk action

## Path parameters

- `actionId` string, required

## Response `200`

Bulk action details

- 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.

## Other responses

- `404`: Bulk action not found

## Changes

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

[Operation history](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/changes/v2/workflows/bulkActions/:actionId/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)