Choose your language

Choose your login

Contact us

Status per printer and per device URLs

This page applies to:

In addition to the summary status URLs for printers and devices, PaperCut NG/MF provides URLs for every printer and every device. You can use either the JSON attribute on each of these URLs, or the HTTP response codes depending on the capabilities of your monitoring tool.

These URLs provide the following simple HTTP response codes that can be consumed by most monitoring tools:

  • 200—Success

  • 500—Error

For example, if a printer is offline, the /api/health/printers/[printer Id]/status URL will return a status code of 500 (Error).

If you use the JSON attribute, more detailed status information is available when the status is not OK, for example, “Printer is out of toner”.

EXAMPLE

Per printer URLs

The printer URLs are located below:

http://[primary_server]:[port]/api/health/printers/[printer Id]

The following URLs are provided per printer.

URLAttributeDescription
/statusstatusThe status of the printer.This is either OK, or an error message is displayed.
 commentA description of the URL.
/has-recent-jobs?minutes=60statusIndicates whether or not a job has been sent to the printer in a defined period of time. The default time period is 60 minutes, however, you can change this to a value up to 240 minutes by changing the ?minutes=60 value.
 commentA description of the URL.

Per device URLs

The device URLs are located below:

http://[primary_server]:[port]/api/health/devices/[device Id]

The following URLs are provided per device.

URLAttributeDescription
/statusstatusThe status of the device in error.This is either OK, or an error message is displayed.
 commentA description of the URL.
/has-recent-jobs?minutes=60statusIndicates whether or not a job has been sent to the device in a defined period of time. The default time period is 60 minutes, however, you can change this to a value up to 240 minutes by changing the ?minutes=60 value.
 commentA description of the URL.

Comments