---
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

---

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