Generate guarantee labels automatically: via API or CSV
For merchants with a large catalogue or their own system integration: generate guarantee labels in bulk instead of one by one.
CSV upload
Upload a spreadsheet with the columns brand,
model, duration (guarantee duration in
years, as a number), and optionally force_regeneration
(1 forces a new label, 0 or empty reuses an
existing one), either comma- or semicolon-separated. Processing runs
in the background with a progress indicator, even for very large
files. This applies even if you reload or leave the page.
Example file
Comma-separated
brand,model,duration,force_regeneration
adidas,adi-23423,2,1
nike,super-123123,2,0
Fila,fi3123-G,1,1 Semicolon-separated
brand;model;duration;force_regeneration
adidas;adi-23423;2;1
nike;super-123123;2;0
Fila;fi3123-G;1;1 At the end you receive a result file with an additional column containing the generated guarantee label URL for each row.
What your input file might look like.
The result file you get back, with the generated label URLs.
Selling on Amazon, eBay, Shopify, or Shopware? See our platform-specific guides → for how to embed the generated images there.
API integration
Connect your webshop or inventory system directly via a personal API key. Treat it like a password and don't share it publicly.
curl -X POST https://api.garan-label.com/v1/labels \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"brand":"ACME","model":"X-200","duration":"3 years"}' <?php
$ch = curl_init('https://api.garan-label.com/v1/labels');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'brand' => 'ACME',
'model' => 'X-200',
'duration' => '3 years',
]),
]);
$response = curl_exec($ch); import requests
response = requests.post(
"https://api.garan-label.com/v1/labels",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"brand": "ACME", "model": "X-200", "duration": "3 years"},
) const response = await fetch("https://api.garan-label.com/v1/labels", {
method: "POST",
headers: {
Authorization: "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({ brand: "ACME", model: "X-200", duration: "3 years" }),
}); Grant temporary access to your account
Need an agency, freelancer, or employee to generate labels for you? In the portal, under "Grant account access", you can invite a third party by email and choose how long they can log in on your behalf, for example 48 hours. During that time, they can use manual entry and CSV upload just like you can.
The invited person sees your existing labels and usage data and uses your credits while access is active. Account settings, credit purchases, and further invitations remain reserved to you. Only grant access to people you trust.
Pricing for bulk usage
The more labels you generate, the cheaper the price per unit: from €1.25 down to €0.08 per label.
| Credits | Price | Price per label |
|---|---|---|
| 20 | €25.00 | €1.25 |
| 50 | €42.00 | €0.84 |
| 150 | €79.00 | €0.53 |
| 500 | €149.00 | €0.30 |
| 1,000 | €219.00 | €0.22 |
| 10,000 | €800.00 | €0.08 |
All prices exclude statutory VAT. 1 credit equals 1 newly generated label. Identical repeats (same brand, model, warranty duration) do not cost an additional credit. No subscription, no minimum purchase.
Questions about API & CSV
Is there a limit for CSV processing?
Even very large files are processed reliably. Generation continues in the background even if you reload or leave the page.
Does a repeated request for the same product cost another credit?
No. If you request an already generated label again with identical brand, model, and guarantee duration, you receive the existing image without an additional credit. Only an actual re-generation uses one.
Can I test the API in sandbox mode?
Yes, sandbox mode can also be used via API and CSV, to check layout and integration without using credits.
How secure is my API key?
It identifies your account to the interface and should be treated like a password. If accidentally shared, contact support.
Is the GARAN-Label the same as the legal guarantee label?
No. The legal guarantee label concerns statutory liability for defects and is mandatory for every seller, regardless of any manufacturer guarantee. The GARAN-Label only concerns voluntary manufacturer guarantees of more than two years. Full comparison →