Quickstart

Convert ZPL to a PDF in one request.

1. Get an API key

Create an account and generate a key in the dashboard. Keys look like zpl_… and are shown only once.

2. Send ZPL, get the PDF

POST your ZPL to /v1/convert with your key in the X-API-Key header. By default the response body is the raw PDF and nothing is stored — private by default, on every plan.

curl -X POST https://api.zpljet.com/v1/convert \
  -H "X-API-Key: zpl_your_key" \
  -H "Content-Type: application/json" \
  -d '{"zpl":"^XA^FO50,50^A0N,50,50^FDHello^FS^XZ"}' \
  --output label.pdf

3. Or host it and get a URL

On a paid plan, pass "output": "url" to store the file and get back a signed link instead. Set retentionDays to control how long it's kept (up to your plan's maximum).

curl -X POST https://api.zpljet.com/v1/convert \
  -H "X-API-Key: zpl_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "zpl": "^XA^FO50,50^A0N,50,50^FDHello^FS^XZ",
    "output": "url",
    "retentionDays": 7
  }'

The response is JSON:

{
  "id": "7c9fc824-8d30-4bb9-ba36-03d3bcf574bf",
  "url": "https://…r2.cloudflarestorage.com/…/file.pdf?…",
  "pages": 1,
  "retentionDays": 7,
  "expiresAt": "2026-07-08T20:09:22.333Z",
  "urlExpiresAt": "2026-07-08T20:09:22.333Z"
}

expiresAt is when the file is deleted; urlExpiresAt is when the signed link stops working (capped at 7 days — request a fresh conversion if the file outlives its link).

Next: read the API reference for all parameters, or learn about authentication. Official JavaScript and Python SDKs are coming soon.