Barcode API

Generate a Barcode

Type QR Code Code 128 Code 39 Code 93 EAN-13 EAN-8 Codabar Aztec Data Matrix PDF 417 2 of 5

Data

Generate

Label Text

+ Size options

Width (px)

Height (px)

DPI

Download PNG Download ZPL

Printable Label Sheets

Create print-ready label sheets with barcodes sized for thermal printers. Supports Zebra, Brother QL, and DYMO LabelWriter presets.

Create a Sheet

POST /sheets
Content-Type: application/json

# Using a label preset (default TTL: 1 day)
curl -X POST /sheets \
  -H "Content-Type: application/json" \
  -d '{
    "id": "warehouse-42",
    "label_preset": "zebra_2x1",
    "barcodes": [
      {"type": "code128", "data": "SKU-001", "label_text": "Widget A"},
      {"type": "code128", "data": "SKU-002", "label_text": "Widget B"},
      {"type": "qr", "data": "https://example.com/item/3"}
    ]
  }'

# With custom TTL (7 days) and custom dimensions (mm)
curl -X POST /sheets \
  -H "Content-Type: application/json" \
  -d '{
    "id": "custom-labels",
    "ttl": "7d",
    "label_width_mm": 62,
    "label_height_mm": 29,
    "barcodes": [
      {"type": "code128", "data": "ITEM-100", "label_text": "Custom label"}
    ]
  }'

Response (201 Created)

{
  "id": "warehouse-42",
  "url": "/sheets/warehouse-42",
  "barcode_count": 3,
  "label_preset": "zebra_2x1",
  "label_width_mm": 50.8,
  "label_height_mm": 25.4,
  "expires_at": "2026-02-11T13:00:00Z"
}

View & Print

GET /sheets/{id}
GET /sheets/{id}?view=dense

Opens a print-ready HTML page. Click "Print Labels" or press Ctrl+P — each barcode prints on one physical label with zero margins.

Use ?view=dense for a compact view that shows a single label preview with a summary count. Ideal for embedding in iframes. All labels are still included when printing.

Combine with ?preset= to re-layout, e.g. /sheets/{id}?view=dense&preset=zebra_4x6.

Sheet Request Fields

Label Presets

All supported presets are also available as a machine-readable JSON file: GET /presets.json

Single Barcode

GET /barcode/{type}/{data}?width=200&height=200&dpi=72&label_text=My+Label&format=png

Returns a barcode image. All query params are optional. Set label_text to render custom text below the barcode.

Output Formats

Examples

# QR code (PNG)
curl -o qr.png /barcode/qr/hello-world

# Code128 with custom size
curl -o code.png "/barcode/code128/ABC-123?width=400&height=150"

# ZPL output for Zebra printers
curl "/barcode/code128/ABC-123?format=zpl"

# ZPL with label text
curl -o label.zpl "/barcode/ean13/5901234123457?format=zpl&label_text=My+Product"

# Embed in HTML
<img src="/barcode/ean13/5901234123457" />

Supported Types

Batch (PDF or ZPL)

POST /barcode/batch
Content-Type: application/json

Returns multiple barcodes as a single file. Defaults to PDF (grid layout); set "format": "zpl" for concatenated ZPL labels.

PDF Example

curl -o barcodes.pdf -X POST /barcode/batch \
  -H "Content-Type: application/json" \
  -d '{
    "page_size": "A4",
    "columns": 3,
    "barcodes": [
      {"type": "qr", "data": "First"},
      {"type": "qr", "data": "Second"},
      {"type": "code128", "data": "ITEM-001"}
    ]
  }'

ZPL Example

curl -o barcodes.zpl -X POST /barcode/batch \
  -H "Content-Type: application/json" \
  -d '{
    "format": "zpl",
    "barcodes": [
      {"type": "code128", "data": "ITEM-001"},
      {"type": "ean13", "data": "5901234123457", "label_text": "EAN Product"}
    ]
  }'

Configuration

All via environment variables:

Other Endpoints