Check Printer Status

Last updated:2026-04-30 10:00:48

Check printer availabilityCheck whether the device is offline, idle, printing, faulty or under maintenance.

What do I need before starting?

Prepare a connected printer, its ID and key, an accessible image URL and physical print dimensions. Keep the key on your server.

Submission is not completion. Save the returned task ID. Call Start Print only when the device requires a second confirmation.

Next:Submit your first print job →

To query the printer status, third-party platforms may invoke a specific interface to send a command to the Open Platform requesting the current status. Upon processing the request, the platform will synchronously return the result.

Interface Information

API Endpoint https://www.colorpark.cn/api/printer/getPrinterStatus
Request Method POST

Request Parameters

| Parameter Name | Parameter Value (Example) | Data Type | Required | Parameter Description | | ---- | ---- | :----: | ---- | | printer_id | 500001 | string | Yes | The unique ID assigned to the printer; each printer is assigned a distinct number. | | once | 8305 | string | Yes | A random value used during encryption to generate the signature. | | time | 1646790335 | string | Yes | The timestamp used during encryption to generate the signature. | | sign | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | string | Yes | The generated signature; for details on the generation method, please refer to the "Generating Signatures" section within Underlying Methods [Basic Support]. |

Return Results

Parameter Name Sub-parameter Name Data Type Parameter Value (Example) Description
code string 0 Return status code: 0 for success, 1 for failure.
msg string Success Description of the return result (e.g., "Success").
data msg string Offline Printer status description (e.g., "Offline").
status string 0 Print task status: 0 - Offline, 1 - Idle, 2 - Printing, 3 - Fault, 4 - Maintenance.
notice_time string 2025-11-28 14:42:28 Notification timestamp.

If you encounter any unresolved issues during the device debugging process, please contact the Cloud Printing representative for troubleshooting and assistance in finding a solution. Contact details are as follows: Phone: 137-5177-4454 (Available on WeChat) Email: info@ColorPark.cn

A UV Cloud Printing Service Provider with Deep Hardware-Software Integration ®RefineColor