Skip to content
LabelZoom Docs

Quickstart

Convert ZPL to a PDF with a single request:

Terminal window
curl -X POST "https://api.labelzoom.com/api/v2/convert/zpl/to/pdf" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: text/plain" \
  -d '^XA^FO50,50^ADN,36,20^FDLabelZoom^FS^XZ' \
  --output label.pdf

Open label.pdf — you’ll see the label exactly as a Zebra printer would print it.

Get an API key

Section titled “Get an API key”
  1. Create a free LabelZoom account.
  2. Open your dashboard and copy your API key.

The free tier converts unlimited labels with a watermark; paid plans remove it and add SLAs.

The conversion endpoint

Section titled “The conversion endpoint”

Every conversion uses the same pattern:

POST https://api.labelzoom.com/api/v2/convert/{source}/to/{target}
Supported values
Source formats zpl, epl, tspl, dpl, pdf, png, bmp, gif, jpg/jpeg, xml, json, url
Target formats pdf, png, bmp, gif, jpeg, zpl, xml, json

Send the label code (Content-Type: text/plain) or file bytes as the request body; the response body is the converted file.

See Supported formats for the content type each format needs, how to convert straight from a URL, and which conversion pairs require a paid plan.

Query parameters

Section titled “Query parameters”
Parameter Meaning Default
label.width Label width in inches 4
label.height Label height in inches 6
dpi Print density: 152, 203, 300, or 600 203

Example — a 4×6 inch label at 300 dpi:

POST /api/v2/convert/zpl/to/png?label.width=4&label.height=6&dpi=300

Many more parameters are available — rotation, scaling, color mode, variable-data filling, and PDF/ZPL options. See Conversion parameters for the full list.

Next steps

Section titled “Next steps”