---
title: "Get bulk-create-and-register-proteins-and-components task status"
method: GET
path: "/api/v3/tasks/bulk-create-and-register-proteins-and-components/{task_id}"
tags: ["Protein"]
---

# Get bulk-create-and-register-proteins-and-components task status

`GET /api/v3/tasks/bulk-create-and-register-proteins-and-components/{task_id}`

## Request

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

Get the current status of a bulk-create-and-register-proteins-and-components task.
When a job reaches a `COMPLETED` status, you can call the
`GET /tasks/bulk-create-and-register-proteins-and-components/{task_id}/results`
endpoint to fetch task results and errors.

Task IDs for this endpoint remain queryable for 14 days after the
job is created.
After that TTL expires, this endpoint returns 404. Retrieve any status
and results you need before the task ID expires.

## Path parameters

- `task_id` string, required

## Headers

- `EARLY-ACCESS` string

## Response `200`

Job status details

- ProteinBulkCreateAndRegisterProteinsAndComponentsTaskGetResponse200
  - `message` string, nullable: A human-readable message describing why the task failed. Present only when status is FAILED.
  - `result` TasksBulkCreateAndRegisterProteinsAndComponentsTaskIdGetResponsesContentApplicationJsonSchemaResult, required
    - `hasErrors` boolean, required
    - `hasSuccess` boolean, required
  - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: The current status of the task. - NOT_STARTED: Task has been created but not yet started. - IN_PROGRESS: Task is currently running. - COMPLETED: Task finished. Check 'result.hasErrors' to determine if there were validation errors. - FAILED: Task encountered an internal error (system failure). This is distinct from user-facing validation errors, which result in a COMPLETED status with hasErrors=true.
  - `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/3873a10bf7b8?raw)