---
title: "POST /2023-10-12/batch-get-task"
method: POST
path: "/2023-10-12/batch-get-task"
---

# POST /2023-10-12/batch-get-task

`POST /2023-10-12/batch-get-task`

Retrieves multiple tasks in a single request. This is a batch version of the `GetTask` API.

The result of getting each task is reported individually in the response. Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of 200.

## Request body

- object
  - `identifiers` BatchGetTaskIdentifier[], required — The list of task identifiers to retrieve. You can specify up to 100 identifiers per request.
    - `farmId` string, required — The farm ID of the task.
    - `queueId` string, required — The queue ID of the task.
    - `jobId` string, required — The job ID of the task.
    - `stepId` string, required — The step ID of the task.
    - `taskId` string, required — The task ID.

## Response `200`

Success

- BatchGetTaskResponse
  - `tasks` BatchGetTaskItem[], required — A list of tasks that were successfully retrieved.
    - `farmId` string, required — The farm ID of the task.
    - `queueId` string, required — The queue ID of the task.
    - `jobId` string, required — The job ID of the task.
    - `stepId` string, required — The step ID of the task.
    - `taskId` string, required — The task ID.
    - `createdAt` string, date-time, required — The date and time the resource was created.
    - `createdBy` string, required — The user or system that created this resource.
    - `runStatus` 'PENDING' | 'READY' | 'ASSIGNED' | 'STARTING' | 'SCHEDULED' | 'INTERRUPTING' | 'RUNNING' | 'SUSPENDED' | 'CANCELED' | 'FAILED' | 'SUCCEEDED' | 'NOT_COMPATIBLE', required — The run status of the task.
    - `targetRunStatus` 'READY' | 'FAILED' | 'SUCCEEDED' | 'CANCELED' | 'SUSPENDED' | 'PENDING' — The run status with which to start the task.
    - `failureRetryCount` integer — The number of times the task failed and was retried.
    - `startedAt` string, date-time — The date and time the resource started running.
    - `endedAt` string, date-time — The date and time the resource ended running.
    - `updatedAt` string, date-time — The date and time the resource was updated.
    - `updatedBy` string — The user or system that updated this resource.
    - `latestSessionActionId` string — The latest session action for the task.
    - `parameters` object — The parameters for the task.
  - `errors` BatchGetTaskError[], required — A list of errors for tasks that could not be retrieved.
    - `farmId` string, required — The farm ID of the task that could not be retrieved.
    - `queueId` string, required — The queue ID of the task that could not be retrieved.
    - `jobId` string, required — The job ID of the task that could not be retrieved.
    - `stepId` string, required — The step ID of the task that could not be retrieved.
    - `taskId` string, required — The task ID of the task that could not be retrieved.
    - `code` 'InternalServerErrorException' | 'ResourceNotFoundException' | 'ValidationException' | 'AccessDeniedException' | 'ThrottlingException', required — The error code.
    - `message` string, required — The error message.

## Other responses

- `480` — AccessDeniedException
- `481` — InternalServerErrorException
- `482` — ThrottlingException
- `483` — ValidationException

---

[API](https://skmtc.net/aws/apis/deadline.md) · [All operations](https://skmtc.net/aws/apis/deadline/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/deadline/versions/259a7ebfefa8/schema)