Skip to main content
GET
List serverless endpoint workers
Required API key scope: serverless:read

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.

Console sessions (Clerk JWTs) act for the signed-in user. To act for a team instead, also send X-Team-Id: <team_id>; it applies only when the user owns or belongs to that team, otherwise the request runs against the user's own account. API keys created inside a team already act for that team and do not need the header.

Path Parameters

id
string
required

Serverless endpoint identifier

Response

OK

workers
object[]
required
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).

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

Last modified on November 18, 2026