API Integration

The zpl.tools API renders ZPL labels to PNG and PDF over HTTP.

• Base URL: https://api.zpl.tools
• Authentication: X-API-Key header, required on every request except the health check
• Output formats: PNG and PDF
• Limits: no page-count limit, no request-body-size limit, no rate limits

Start here

• Quickstart — render your first label.
• Render multi-page retailer packets — the batch workflow.
• API Reference — every endpoint, parameter, and error code.
• Diagnostics Reference — opt-in linting that reports ignored commands and defaults with every render.

Migration from Labelary

The rendering endpoints accept the Labelary request shape. Change the base URL and keep the rest of the request. The migration guide gives the exact change, side-by-side code samples, and a checklist.

Compatibility status

The rendering surface matches Labelary's documented behavior for:

• PNG and PDF output through GET and POST;
• the dpmm, dimension and index path parameters;
• the X-Rotation, X-Quality and X-Linter headers;
• validation of the PDF page-layout headers.

The largest gaps are full page composition for the X-Page-* headers, the alternate print languages EPL, IPL, DPL, SBPL and PCL, and JSON label-data extraction. The Labelary Compatibility page lists every difference, closed or open.

Support

Contact us at zpl.tools/contact.