Printago API
GET /v1/maintenance/printers/{printerId}/status

Get printer maintenance status

Get maintenance enrollments and status for a specific printer

Requires: maintenance.view

Path Parameters

printerId required
string
The printer ID

Response Schema

MaintenanceStatusInfo[]
Array of MaintenanceStatusInfo, each with:
elapsedrequired
number
enrollmentIdrequired
string
pattern: ^[a-z0-9]{24}$
intervalrequired
number
itemNamerequired
string
lastCompletedAtrequirednullable
string
format: date-time
lastCompletedByrequirednullable
string
maintenanceItemIdrequired
string
pattern: ^[a-z0-9]{24}$
printerIdrequired
string
pattern: ^[a-z0-9]{24}$
printerNamerequired
string
progressrequired
number
statusrequired
"OK" | "DUE_SOON" | "OVERDUE"
OKDUE_SOONOVERDUE
triggerTyperequired
"print_hours" | "calendar_days" | "job_count"
print_hourscalendar_daysjob_count
warningThresholdPctrequired
number

Example Response

200 OK — application/json 
[
  {
    "enrollmentId": "string",
    "printerId": "string",
    "maintenanceItemId": "string",
    "printerName": "string",
    "itemName": "string",
    "triggerType": "print_hours",
    "interval": 1,
    "elapsed": 1,
    "progress": 1,
    "status": "OK",
    "warningThresholdPct": 1,
    "lastCompletedAt": "2025-01-15T12:00:00.000Z",
    "lastCompletedBy": "string"
  }
]