---
title: "Get bulk task status"
method: GET
path: "/api/v3/tasks/bulk/{task_id}"
tags: ["tasks"]
---

# Get bulk task status

`GET /api/v3/tasks/bulk/{task_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/tasks/bulk/{task_id}`
- Auth: HTTP bearer

Get the current status of a bulk task. The response includes information about the task's progress
and status. On SUCCESS, you can retrieve the successful payload for the bulk task from
/tasks/bulk/{task_id}/successful-results. On FAILED, you can additionally retrieve
errors from /tasks/bulk/{task_id}/errors.

## Path parameters

- `task_id` string, required

## Headers

- `EARLY-ACCESS` string

## Response `200`

Job status details

- TasksBulkTaskGetResponse200
  - `progress` TasksBulkTaskIdGetResponsesContentApplicationJsonSchemaProgress, required
    - `numberProcessed` integer, required
    - `totalRecords` integer, required
  - `result` TasksBulkTaskIdGetResponsesContentApplicationJsonSchemaResult, required
    - `errorCount` integer, required
    - `successCount` integer, required
  - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required
  - `taskId` string, required

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/benchling/apis/benchling-api.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api/revisions/c9f087b98b8b?raw)