---
title: "List Workers"
method: GET
path: "/v1/workers"
tags: ["Workers"]
---

# List Workers

`GET /v1/workers`

Returns a list of all registered workers in the runtime. Workers are configurable processing units that can perform tasks like load balancing between models or implementing fallback strategies.

## Query parameters

- `format` 'json' | 'csv'

## Response `200`

List of workers in JSON format

- WorkerListResponse — Response wrapper for the `/v1/workers` endpoint.
  - `data` WorkerInfo[], required — The list of workers
    - `description` string, nullable — A description of what the worker does
    - `is_llm` boolean, required — Whether this worker can be used as an LLM model
    - `name` string, required — The name of the worker
    - `status` 'Initializing' | 'Ready' | 'Disabled' | 'Error' | 'Refreshing' | 'ShuttingDown' — Represents the status of a component (e.g. dataset, model, etc).
  - `object` string, required — The type of the response (always `list`)

## Other responses

- `500` — Internal server error occurred while processing workers

## Changes

- **2026-02-06** `c4d7063e0abe` — 1 info
  - endpoint added
- **2025-03-18** `dd94571fef79` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/spiceai/apis/runtime/changes/v1/workers/get.md)

---

[API](https://skmtc.dev/spiceai/apis/runtime.md) · [All operations](https://skmtc.dev/spiceai/apis/runtime/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spiceai/runtime/revisions/c4d7063e0abe/schema)