API

ZPL Render API Access.

This host serves the demo, the health probe, the JSON render API, and the OpenAPI contract from one place.

GET /health

Service status.

Used by probes, launchers, and health checks to confirm the host is ready.

Checking service... Probing /health

Plans and Pricing

Free to start. Premium plans for higher throughput and support.

Monthly billing is selected by default. Yearly billing is discounted for customers who want to commit for longer. Free usage does not require sign-up, while premium plans add higher limits, private hosting options, and support commitments.

Free Free Plus 70€/month Business 190€/month On-Prem Email Us
Deployment Model SaaS SaaS SaaS On-Premise
Support None Basic Premium Premium
Availability SLA None 99% 99.9% Custom
Release Channel Beta Stable Stable Stable
Maximum Data Retention 60 days Never Never Never
Maximum Requests per Second 3 6 10 No Limit
Maximum Requests per Day 5,000 20,000 40,000 No Limit
Provisioning None Email delivery Email delivery None
API Server Public host Provided via email Provided via email On-Premise servers
Sign Up Sign Up Sign Up Email Us

POST /api/render

Render ZPL from JSON.

Send the label text plus renderer options in one body. The response returns normalized ZPL, the command tree, element metadata, and optional image bytes.

{
  "zpl": "^XA^FO50,50^FDHello World^FS^XZ",
  "includeImage": true,
  "options": {
    "prettyPrint": true,
  "wrapInFormat": true
  }
}

POST /api/render/png

Download the rendered label as PNG.

This endpoint accepts the same JSON body as /api/render, and it also accepts plain-text ZPL from a .zpl file. It returns a ready-to-save image/png file with an attachment filename.

For a file-based request, save your label as label.zpl and make sure the file contains ZPL only, not JSON.

curl.exe -k -X POST "https://renderlabels.com/api/render/png" -H "Content-Type: text/plain; charset=utf-8" --data-binary "@label.zpl" --output rendered-label.png

If you want a visible test label, start the file with a larger font, for example ^CF0,60. PowerShell users can use Invoke-WebRequest with -OutFile rendered-label.png.

Examples

Client snippets for /api/render.

These snippets target the current host's /api/render endpoint and all send the same JSON request shape.

Windows Command Prompt users should paste the curl.exe example as a single line. PowerShell users should use the dedicated PowerShell block below.

OpenAPI JSON