---
title: "GET /1/workers"
method: GET
path: "/1/workers"
---

# GET /1/workers

`GET /1/workers`

## Query parameters

- `active` boolean
- `factory` string, nullable
- `limit` integer, nullable
- `page_token` string, nullable

## Response `200`

successful operation

- WorkerResultsPage — A single page of results
  - `items` Worker[], required — list of items on this page of results
    - `bootstrap` boolean, required
    - `deleted` boolean, required
    - `diagnostics` boolean, required
    - `factory` string, required
    - `factory_ip` string, nullable
    - `factory_private` string, nullable
    - `hold` WorkerHold
      - `reason` string, required
      - `time` string, date-time, required
    - `id` string, required
    - `jobs` WorkerJob[], required
      - `id` string, required
      - `name` string, required
      - `owner` string, required
      - `state` string, required
      - `tags` object, required
    - `lastping` string, date-time, nullable
    - `recycle` boolean, required
    - `target` string, required
  - `next_page` string, nullable — token used to fetch the next page of results (if any)

## Other responses

- `4XX` — Error
- `5XX` — Error

## Changes

> 17 revisions in range; 1 not diffed.

- **2024-03-13** `8052886c11a6` — 1 info
  - added the optional property `items/items/factory_ip` to the response with the `200` status
- **2024-03-11** `7962484a2c41` — 1 info
  - added the required property `items/items/diagnostics` to the response with the `200` status
- **2024-02-28** `4973c53ff968` — 1 info
  - added the optional property `items/items/hold` to the response with the `200` status
- **2024-01-11** `24af41f00572` — 1 info
  - added the new optional `query` request parameter `factory`
- **2024-01-09** `cf24b25fd671` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/oxidecomputer/apis/buildomat/changes/1/workers/get.md)

---

[API](https://skmtc.dev/oxidecomputer/apis/buildomat.md) · [All operations](https://skmtc.dev/oxidecomputer/apis/buildomat/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oxidecomputer/buildomat/revisions/7c904bfdde4a/schema)