List serverless endpoint workers

List active workers for a Runpod Serverless endpoint with worker status, runtime details, and summary counts grouped by status.

GET /v2/serverless/{id}/workers

List serverless endpoint workers

cURL

curl --request GET \
  --url https://api.runpod.io/v2/serverless/{id}/workers \
  --header 'Authorization: Bearer <token>'

200

{
  "endpointVersion": 4,
  "summary": {
    "running": 1,
    "idle": 1,
    "initializing": 0,
    "throttled": 0,
    "unhealthy": 0,
    "total": 2
  },
  "workers": [
    {
      "id": "8g3n5t6r",
      "status": "RUNNING",
      "isStale": false,
      "version": 4,
      "gpuCount": 1,
      "image": "runpod/pytorch:1.0.2-cu1281-torch280-ubuntu2404",
      "uptimeSeconds": 3600,
      "gpuTypeId": "NVIDIA GeForce RTX 4090",
      "dataCenterId": "US-KS-2",
      "startedAt": "2026-06-01T12:05:00Z"
    }
  ]
}

Authorizations

Authorization · string · header · required

Runpod API key authentication. Generate an API key in the Runpod console and send it in the Authorization header as Bearer <api_key>. Keys are scoped to the permissions granted when created; requests may return 403 when a valid key lacks access to the requested resource or action.

Path Parameters

id · string · required

Serverless endpoint identifier

Response

200

application/json

OK

workers · object[] · required

Show child attributes

summary · object · required

Histogram of the returned workers by status. The per-status counts are a roll-up of the workers array, so running + idle + initializing + throttled + unhealthy == total == len(workers).

Show child attributes

endpointVersion · integer | null

The endpoint's current configuration version. A worker whose version differs is running stale config (see worker.isStale). Null if unknown.

Example:

4