Printago API
GET /v1/reports/printers

Printers report

Per-machine utilization, idle gaps, leaderboard and maintenance posture.

Requires: analytics.view

Query Parameters

start required
string
end required
string
printerIds optional
string
Comma-separated printer ids; omitted = all printers.

Response Schema

PrintersReport
foreignJobEventsrequired
number
printing-foreign-job events in range — machines driven outside Printago.
idleGapsrequired
object[]
job-finished -> next printing-assigned-job, per physical machine.
gapsrequired
number
medianGapMinutesrequired
number
p95GapMinutesrequired
number
printerDeviceIdrequired
string
printerNamerequired
string
leaderboardrequired
object[]
completedrequired
number
failedrequired
number
failureRaterequired
number
gramsrequired
number
hoursrequired
number
printerDeviceIdrequired
string
printerNamerequired
string
printsrequired
number
maintenancerequired
object
duerequired
number
enrolledrequired
number
overduerequired
number
printersrequired
object[]
printerDeviceIdrequired
string
printerNamerequired
string
rangerequired
object
daysrequired
number
endrequired
string
startrequired
string
timezonerequired
string
utilizationByDayrequired
object[]
daterequired
string
printerDeviceIdrequired
string
printingHoursrequired
number

Example Response

200 OK — application/json 
{
  "range": {
    "start": "string",
    "end": "string",
    "timezone": "string",
    "days": 1
  },
  "printers": [
    {
      "printerDeviceId": "string"
    }
  ],
  "utilizationByDay": [
    {
      "date": "string",
      "printerDeviceId": "string",
      "printingHours": 1
    }
  ],
  "idleGaps": [
    {
      "printerDeviceId": "string",
      "gaps": 1
    }
  ],
  "leaderboard": [
    {
      "printerDeviceId": "string",
      "prints": 1,
      "completed": 1,
      "failed": 1,
      "grams": 1,
      "hours": 1
    }
  ],
  "maintenance": {
    "enrolled": 1,
    "due": 1,
    "overdue": 1
  },
  "foreignJobEvents": 1
}