---
title: "Retrieve the status of all tasks affected by a bulk action and download a CSV"
method: GET
path: "/v1/tasks/bulk-status/{bulkActionId}"
tags: ["tasks"]
---

# Retrieve the status of all tasks affected by a bulk action and download a CSV

`GET /v1/tasks/bulk-status/{bulkActionId}`

## Request

- Base URL: `https://developer.saleshandy.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.saleshandy.com/v1/tasks/bulk-status/{bulkActionId}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/docs/v1/tasks/bulk-status/:bulkActionId/get.ts> (a function with typed inputs; its response is checked against the schema)

While performing bulk operations using `v1/tasks/bulk-snooze` and `v1/tasks/bulk-skip`, you will receive the **bulkActionId**.

Using that **bulkActionId**, you can check the status of the bulk operation process. If there is any error during the bulk operation process, you will receive a **CSV file link** containing the error details.

## Path parameters

- `bulkActionId` string, required

## Response `200`

Bulk task status fetched successfully

- BulkTaskStatusResponseDTO
  - `bulkActionId` string, required: Unique identifier for the bulk action
  - `action` 'snooze' | 'skip', required: Type of bulk action performed
  - `totalTasks` number, required: Total number of tasks in the bulk action
  - `completed` number, required: Number of tasks completed successfully
  - `failed` number, required: Number of tasks that failed
  - `pending` number: Number of pending tasks (only present when status is in_progress)
  - `status` 'in_progress' | 'completed' | 'failed', required: Current status of the bulk action
  - `createdAt` string, date-time, required: Date and time when the bulk action was created
  - `completedAt` string, date-time, nullable, required: Date and time when the bulk action was completed (null if in progress)
  - `csvDownloadLink` string, nullable, required: Download link for CSV with detailed results (null if in progress)

## Other responses

- `400`: 1001: Invalid token<br><br>
- `500`: 5001: Internal server error, please try again later<br><br>

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) - [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) - [OpenAPI document](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/revisions/e7a29c931aa7?raw)