Developer API
Generate GARAN labels at scale, programmatically
A clean REST API for the EU durability guarantee label. Wire it into your PIM, your online shop, or your build pipeline and get spec-conformant labels back in every format you need.
Built for integration
- REST over JSON:API
- Predictable resources, filtering, and pagination following the JSON:API standard, so your client library does most of the work.
- Single labels or batch jobs
- Create one label per request, or queue a batch of up to 500 rows that renders in the background and returns a ZIP.
- Every format and variant
- SVG, PDF, PNG, JPG, and WebP, in the colour, black-and-white, and nested variants, all from the same request.
Endpoints
What you can automate
The API mirrors everything you can do by hand, without the clicks. A high-level view of what each part does.
- Create a label
- Send a guarantee duration, brand, and model, and receive the label with ready-to-use download links per format.
- Browse your library
- List and fetch every label your account has generated, newest first, ready to re-render any time at no extra cost.
- Queue a batch job
- Submit many rows at once and poll the batch until it is ready, then pull the finished ZIP.
- Check usage and credits
- Read your current credit balance and recent activity so your integration can keep an eye on the wallet.
Conventions
Predictable by design
The API follows a small set of rules everywhere, so once you have integrated one endpoint you know how the rest behaves.
- Token authentication
- Create personal access tokens in your settings and send them as a Bearer token in the Authorization header. Revoke any of them at any time.
- Versioned endpoints
- Everything lives under /api/v1, so future changes never break your existing integration without notice.
- JSON:API media type
- Requests and responses use application/vnd.api+json, with resources, relationships, and a consistent envelope.
- Deterministic and cached
- The same three inputs always produce the same label. Responses carry an ETag, so repeat requests return a fast 304 Not Modified.
- Signed download links
- Rendered files are served over short-lived signed URLs, so you can hand a link straight to a browser without exposing your token.
- Rate limits
- A generous per-account limit keeps the service fair and responsive. The limit is returned in standard headers so you can back off gracefully.
- Structured errors
- Errors come back as JSON:API error documents that point at the exact attribute that failed, so validation problems are easy to surface.
Pricing
Pay once per label
You are billed once per unique label, identified by its duration, brand, and model. Re-downloading a label, requesting more formats, or fetching one you already own never costs again.
Top up prepaid credits, or switch to pay as you go and settle monthly for exactly what you generate. Duplicate rows in a batch are only counted once.
Prefer no code?
Upload a spreadsheet and generate the same labels in a batch, no integration required.
Free account
Unlock PDF, WebP and your label library
A free account adds PDF and WebP and saves every label you make to a personal library. It also lets you scale with batch CSV or the API, with 5 trial credits to start.
- PDF and WebP formats, on top of the free SVG, PNG and JPG.
- A saved label library: re-download anything you have made, any format or variant, free.
- Batch generation from a CSV, up to 500 rows per file, returned as a ZIP.
- REST API for your PIM, online shop, or build pipeline, with 5 trial credits to start.