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

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

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

Retrieves multiple workers in a single request. This is a batch version of the `GetWorker` API.

The result of getting each worker 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` BatchGetWorkerIdentifier[], required — The list of worker identifiers to retrieve. You can specify up to 100 identifiers per request.
    - `farmId` string, required — The farm ID of the worker.
    - `fleetId` string, required — The fleet ID of the worker.
    - `workerId` string, required — The worker ID.

## Response `200`

Success

- BatchGetWorkerResponse
  - `workers` BatchGetWorkerItem[], required — A list of workers that were successfully retrieved.
    - `farmId` string, required — The farm ID of the worker.
    - `fleetId` string, required — The fleet ID of the worker.
    - `workerId` string, required — The worker ID.
    - `hostProperties` object — The host properties for the worker.
      - `ipAddresses` object — The IP address of the host.
        - `ipV4Addresses` IpV4Address[] — The IpV4 address of the network.
        - `ipV6Addresses` IpV6Address[] — The IpV6 address for the network and node component.
      - `hostName` string — The host name.
      - `ec2InstanceArn` string — The ARN of the host EC2 instance.
      - `ec2InstanceType` string — The instance type of the host EC2 instance.
    - `status` 'CREATED' | 'STARTED' | 'STOPPING' | 'STOPPED' | 'NOT_RESPONDING' | 'NOT_COMPATIBLE' | 'RUNNING' | 'IDLE', required — The status of the worker.
    - `log` object — The log configuration for the worker.
      - `logDriver` string, required — The log drivers for worker related logs.
      - `options` object — The options for a log driver.
      - `parameters` object — The parameters for the log configuration.
      - `error` string — The log configuration error details.
    - `createdAt` string, date-time, required — The date and time the resource was created.
    - `createdBy` string, required — The user or system that created this resource.
    - `updatedAt` string, date-time — The date and time the resource was updated.
    - `updatedBy` string — The user or system that updated this resource.
  - `errors` BatchGetWorkerError[], required — A list of errors for workers that could not be retrieved.
    - `farmId` string, required — The farm ID of the worker that could not be retrieved.
    - `fleetId` string, required — The fleet ID of the worker that could not be retrieved.
    - `workerId` string, required — The worker ID of the worker that could not be retrieved.
    - `code` 'InternalServerErrorException' | 'ResourceNotFoundException' | 'ValidationException', 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)