---
title: "A List with the details of all registered and active workers"
method: GET
path: "/v2/workers"
tags: ["v2"]
---

# A List with the details of all registered and active workers

`GET /v2/workers`

## Query parameters

- `type` string

## Headers

- `apikey` string
- `Client-Agent` string
- `X-Fields` string, mask

## Response `200`

Workers List

- WorkerDetails[]
  - `type` 'image' | 'text' | 'interrogation' — The Type of worker this is.
  - `name` string — The Name given to this worker.
  - `id` string — The UUID of this worker.
  - `online` boolean — True if the worker has checked-in the past 5 minutes.
  - `requests_fulfilled` integer — How many images this worker has generated.
  - `kudos_rewards` number — How many Kudos this worker has been rewarded in total.
  - `kudos_details` WorkerKudosDetails
    - `generated` number — How much Kudos this worker has received for generating images.
    - `uptime` integer — How much Kudos this worker has received for staying online longer.
  - `performance` string — The average performance of this worker in human readable form.
  - `threads` integer — How many threads this worker is running.
  - `uptime` integer — The amount of seconds this worker has been online for this AI Horde.
  - `maintenance_mode` boolean — When True, this worker will not pick up any new requests.
  - `paused` boolean — (Privileged) When True, this worker not be given any new requests.
  - `info` string — Extra information or comments about this worker provided by its owner.
  - `nsfw` boolean — Whether this worker can generate NSFW requests or not.
  - `owner` string — Privileged or public if the owner has allowed it. The alias of the owner of this worker.
  - `ipaddr` string — Privileged. The last known IP this worker has connected from.
  - `trusted` boolean — The worker is trusted to return valid generations.
  - `flagged` boolean — The worker's owner has been flagged for suspicious activity. This worker will not be given any jobs to process.
  - `suspicious` integer — (Privileged) How much suspicion this worker has accumulated.
  - `uncompleted_jobs` integer — How many jobs this worker has left uncompleted after it started them.
  - `models` string[]
  - `forms` string[]
  - `team` TeamDetailsLite
    - `name` string — The Name given to this team.
    - `id` string — The UUID of this team.
  - `contact` string — (Privileged) Contact details for the horde admins to reach the owner of this worker in emergencies.
  - `bridge_agent` string, required — The bridge agent name, version and website.
  - `max_pixels` integer — The maximum pixels in resolution this worker can generate.
  - `megapixelsteps_generated` number — How many megapixelsteps this worker has generated until now.
  - `img2img` boolean — If True, this worker supports and allows img2img requests.
  - `painting` boolean — If True, this worker supports and allows inpainting requests.
  - `post-processing` boolean — If True, this worker supports and allows post-processing requests.
  - `lora` boolean — If True, this worker supports and allows lora requests.
  - `max_length` integer — The maximum tokens this worker can generate.
  - `max_context_length` integer — The maximum tokens this worker can read.
  - `tokens_generated` number — How many tokens this worker has generated until now.

---

[API](https://skmtc.net/haidra-org/apis/ai-horde.md) · [All operations](https://skmtc.net/haidra-org/apis/ai-horde/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/haidra-org/ai-horde/versions/dfeb0bedd935/schema)