Packaging Label API
Generate packaging label images with a single HTTP request. ChartQuery returns publication-ready PNG or SVG output that works everywhere, dashboards, emails, PDFs, print, and more. No frontend library required.
Live Preview
This image is generated in real time by the ChartQuery API, no static assets.
Quick Start
A single HTTP request is all you need. No SDK, no dependencies.
curl -X POST https://api.chartquery.com/v1/label \
-H "Content-Type: application/json" \
-d '{
"width": 100,
"height": 60,
"unit": "mm",
"language": "tsc",
"elements": [
{
"type": "box",
"x": 10,
"y": 10,
"width": 780,
"height": 460,
"thickness": 3
},
{
"type": "text",
"content": "SHIP TO:",
"x": 30,
"y": 30,
"size": 1
},
{
"type": "text",
"content": "Jane Smith",
"x": 30,
"y": 70,
"size": 3
},
{
"type": "text",
"content": "742 Evergreen Terrace",
"x": 30,
"y": 130,
"size": 2
},
{
"type": "text",
"content": "Springfield, IL 62704",
"x": 30,
"y": 180,
"size": 2
},
{
"type": "line",
"x1": 10,
"y1": 230,
"x2": 790,
"y2": 230,
"thickness": 2
},
{
"type": "text",
"content": "FROM: ACME Corp",
"x": 30,
"y": 250,
"size": 1
},
{
"type": "text",
"content": "ORDER #INV-2026-04518",
"x": 30,
"y": 400,
"size": 2
}
]
}' \
--output label.svgHow It Works
Send a Request
POST a JSON body or use GET with query parameters. No SDK or library needed.
Get Your Image
ChartQuery renders your chart, diagram, barcode, QR code, or label and returns it as PNG or SVG.
Use It Anywhere
Embed in emails, PDFs, dashboards, documents, or print directly. Works everywhere images work.
Features
9 Printer Languages
TSC, ZPL, EPL, CPCL, DPL, SBPL, ESC/POS, Star PRNT, and IPL, one definition, any printer.
20 Printer Profiles
Built-in profiles for Zebra, Epson, Star, TSC, SATO, Honeywell, and more. Auto-configures DPI and width.
Rich Element Types
Text, boxes, lines, circles, ellipses, reverse regions, and raw commands for any label design.
Preview & Compile
Preview labels as SVG/PNG images, then compile to raw printer commands ready to send over TCP or USB.
Use Cases
- Shipping and logistics label printing
- Product identification and pricing
- Warehouse bin and shelf labeling
- Receipt and POS thermal printing
Frequently Asked Questions
What is the ChartQuery Packaging Label API?
The ChartQuery Packaging Label API lets you generate packaging label images via a simple HTTP request. Send a JSON configuration and receive a rendered PNG or SVG image in the response. No frontend library, no browser, no dependencies required.
How do I generate a packaging label with an API?
Send a POST request to the ChartQuery label endpoint with your data as JSON. The API returns a rendered image directly. You can also use GET requests with URL parameters for simple cases. No API key is required for basic usage, anonymous access is available with 60 requests per hour.
What output formats does the Packaging Label API support?
SVG (default) and PNG for preview. The Label Compile endpoint outputs raw printer commands (TSC, ZPL, EPL, etc.) ready to send to a thermal printer.
Is the Packaging Label API free to use?
Yes. The ChartQuery Packaging Label API works without an API key. Anonymous access is rate-limited to 60 requests per hour and adds a small watermark. Authenticated users on paid plans get higher limits, no watermark, and longer chart persistence (6 months vs 3 days for shared URLs).
Can I customize the packaging label appearance?
Yes. You have full control over colors, fonts, sizes, backgrounds, legends, and every visual property through the JSON configuration. The API uses Chart.js v4 for charts, and supports all native options for fine-grained customization.
Can I share and embed labels generated by the API?
Yes. Add "share": true to any request to get permanent URLs. The render_url is a direct image URL you can embed in emails, documents, or <img> tags. The view_url is an interactive HTML page you can embed as an iframe. No authentication needed for viewers.
Related APIs
Start generating charts today
No API key required to get started. Generate charts, diagrams, and more with a single HTTP request.
Get StartedView Pricing