List serverless endpoint builds

List a Runpod Serverless endpoint’s GitHub build history, newest first, capped to the 100 most recent builds, with older builds fetchable by ID.

GET /v2/serverless/{id}/builds

List serverless endpoint builds

cURL

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

200

{
  "builds": [
    {
      "id": "build_abc123",
      "status": "COMPLETED",
      "commitHash": "abc1234",
      "commitMessage": "bump model",
      "branch": "main",
      "commitDate": "2026-06-01T12:00:00Z",
      "imageName": "registry.runpod.net/repo:abc1234",
      "startedAt": "2026-06-01T12:00:05Z",
      "completedAt": "2026-06-01T12:04:31Z",
      "error": null
    }
  ],
  "pagination": {
    "nextCursor": null,
    "hasNextPage": false
  }
}

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

Query Parameters

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–100. Defaults to 100 when omitted.

Required range: 1 <= x <= 100

Response

200

application/json

OK

builds · object[] · required

Build history, newest first, cursor-paginated (an omitted limit defaults to 100). Page with cursor/limit to walk the full history, or fetch any build by id via GET /v2/serverless/{id}/builds/{buildId}.

Show child attributes

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.

Show child attributes