Printago API
GET /v1/printer-throttle-groups/leases

List Staggered Start holds

List Staggered Start holds (leases). By default returns only the **active** holds (`releasedAt` is null) — the printers currently reserving or warming a slot. Each lease carries `groupId`, `printerId`, `warmupStartedAt` (set once the job is sent and the printer is heating), and `releasedAt`. Count the ones with a non-null `warmupStartedAt` to get how many printers are warming right now. Pass `includeReleased=true` for the full history.

Requires: printer.view

Query Parameters

includeReleased optional
boolean
Include released (historical) holds, not just the active ones.

Response Schema

Response
value
object[]

Example Response

200 OK — application/json 
[
  {
    "groupId": "string",
    "printerId": "string",
    "printJobId": "string",
    "releaseConditionsSnapshot": {},
    "fallbackTimeoutSecondsSnapshot": 1,
    "temperatureToleranceCSnapshot": 1,
    "acquiredAt": "2026-08-24T03:58:56.387Z",
    "id": "string",
    "storeId": "string",
    "createdAt": "2026-08-24T03:58:56.387Z",
    "updatedAt": "2026-08-24T03:58:56.387Z"
  }
]