---
title: "List bulk actions"
method: GET
path: "/api/v1/bulk-actions"
tags: ["bulk-actions"]
---

# List bulk actions

`GET /api/v1/bulk-actions`

## Request

- Base URL: `https://api.trigger.dev`
- URL: `https://api.trigger.dev/api/v1/bulk-actions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/docs/api/v1/bulk-actions/get.ts> (a function with typed inputs; its response is checked against the schema)

List bulk actions in the current environment. Bulk actions are returned newest first and can be paginated with cursor pagination.

## Query parameters

- `page` object
  - `size` integer: Number of bulk actions per page. Maximum is 100.
  - `after` string: The cursor to start the page after.
  - `before` string: The cursor to start the page before.

## Response `200`

Successful request

- ListBulkActionsResult
  - `data` BulkActionObject[], required
    - `id` string, required: The bulk action ID, prefixed with `bulk_`.
    - `name` string: The name provided when the bulk action was created.
    - `type` 'CANCEL' | 'REPLAY', required
    - `status` 'PENDING' | 'COMPLETED' | 'ABORTED', required
    - `counts` object, required
      - `total` integer, required: The number of runs selected when the bulk action was created.
      - `success` integer, required: The number of runs processed successfully.
      - `failure` integer, required: The number of runs that could not be processed.
    - `createdAt` string, date-time, required
    - `completedAt` string, date-time
  - `pagination` object, required
    - `next` string: Pass this cursor as `page[after]` to retrieve the next page.
    - `previous` string: Pass this cursor as `page[before]` to retrieve the previous page.

## Other responses

- `400`: Invalid query parameters
- `401`: Unauthorized request

## Changes

- **2026-07-10** `840003aec346`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/changes/api/v1/bulk-actions/get.md)

---

[API](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api.md) - [All operations](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/revisions/441161111493?raw)
