Skip to main content
GET
Get serverless endpoint worker metrics

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

Query Parameters

startTime
string<date-time>

Start of the window (RFC 3339), inclusive. Defaults to 24 hours before endTime, rounded down to the start of an interval bucket. Must be within the last 90 days.

endTime
string<date-time>

End of the window (RFC 3339), exclusive. Defaults to now; a future value is treated as now.

interval
enum<string>
default:1h

Bucket size. Defaults to 1h. Bucket size for endpoint metrics.

Available options:
1m,
5m,
15m,
30m,
1h,
6h,
12h,
1d
cursor
string

Opaque resume cursor — pass the previous response's pagination.nextCursor through verbatim; omit for the first page. A cursor is only valid for the operation and parameters that issued it; a malformed or foreign cursor is rejected with 422.

Minimum string length: 1
limit
integer

Page size, 1–1000. Defaults to 1000 when omitted.

Required range: 1 <= x <= 1000

Response

OK

Worker counts by state per bucket for the resolved window. records contains only buckets with activity. Buckets with no activity are omitted, not zero-filled, so records can be shorter than the number of buckets in the window, or empty. Results are paged: see pagination.

startTime
string<date-time>
required

Resolved window start (after defaults).

endTime
string<date-time>
required

Resolved window end (after defaults and the clamp to now).

interval
enum<string>
default:1h
required

Bucket size for endpoint metrics.

Available options:
1m,
5m,
15m,
30m,
1h,
6h,
12h,
1d
records
object[]
required

This page's buckets, oldest first.

pagination
object
required

Cursor-pagination metadata, uniform across list endpoints. Every response carries it: follow nextCursor while hasNextPage is true to walk the full result set.

Last modified on November 3, 2026