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.
At scale
Generate hundreds of labels automatically
A free account lets you generate GARAN labels in a batch or over the API, instead of one at a time. You only pay once you scale.
- 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.
- All five formats and three variants from a single request.
- Saved library, billed once per unique label (prepaid or pay as you go).