---
title: "list workers"
method: GET
path: "/workers/list"
tags: ["worker"]
---

# list workers

`GET /workers/list`

## Query parameters

- `page` integer
- `per_page` integer
- `ping_since` integer

## Response `200`

a list of workers

- WorkerPing[]
  - `worker` string, required
  - `worker_instance` string, required
  - `last_ping` number
  - `started_at` string, date-time, required
  - `ip` string, required
  - `jobs_executed` integer, required
  - `custom_tags` string[]
  - `worker_group` string, required
  - `wm_version` string, required
  - `last_job_id` string
  - `last_job_workspace_id` string
  - `occupancy_rate` number
  - `occupancy_rate_15s` number
  - `occupancy_rate_5m` number
  - `occupancy_rate_30m` number
  - `memory` number
  - `vcpus` number
  - `memory_usage` number
  - `wm_memory_usage` number
  - `job_isolation` string
  - `native_mode` boolean

---

[API](https://skmtc.net/windmill/apis/windmill-api.md) · [All operations](https://skmtc.net/windmill/apis/windmill-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/windmill/windmill-api/revisions/8a5fd82f8851/schema)