Overview
Send print jobs to any physical printer with one REST call. Set up an API key, install the agent, and print your first PDF in about five minutes.
PrintBase Docs
PrintBase connects your application to physical printers anywhere: your backend calls a REST API, a lightweight agent next to the printer receives the job over WebSocket and drives the hardware. No VPN, no exposed printers, real-time status back.
Your App → PrintBase API → Agent → PrinterPrint your first job in five minutes
1. Create an API key. Sign up (free plan, no card) and issue a key from the dashboard — it looks like pb_live_....
2. Install the agent. Download it on any computer that can reach your printer — Windows, macOS, or Linux. Installed printers register automatically; each gets a numeric printer_code you can see in the dashboard or via GET /v1/printers.
3. Send a print job.
curl https://api.printbase.cloud/v1/print-jobs \
-H "Authorization: Bearer pb_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"printer_code": 1000000,
"content_type": "pdf",
"content_url": "https://example.com/hello.pdf"
}'The response gives you a job id; watch it move through queued → dispatched → printing → completed with GET /v1/print-jobs/{id}, or subscribe to webhooks for push updates.
content_type can be pdf for documents or raw for ZPL / ESC-POS byte streams that pass straight through to label and receipt printers. Content is either inline base64 (content) or a URL the agent downloads (content_url).
Guides
- Get Started — the setup walkthrough in full detail
- Agent & WebSocket — how dispatch and status reporting work