For shops with many products

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.

Before uploading you pick the file format for every row in the file: PNG for shop and email, EPS as a vector file for your print shop or an A4 PDF for your own printer. The format applies to the whole upload. Details on the print formats are on the page GARAN-Label as EPS or PDF.

Planning a run for a large catalogue? Which products need a label at all, what it costs and a worked example for 1,000 SKUs: Bulk generation guide →

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. This works the same for every format: for EPS and PDF the column holds the link to the respective print file.

What your input file might look like.

Example result file with an additional Label-URL column

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.

The optional format parameter sets the file format: png (default), eps or pdf. Without it you receive a PNG. Sandbox requests are limited to PNG; EPS and PDF are generated live and cost one credit each.

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
100	€19.00	€0.19
500	€49.00	€0.10
2,000	€144.00	€0.07
10,000	€569.00	€0.06

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.

FAQ

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.

Can I generate print files via CSV or API as well?

Yes. In the CSV upload you choose one file format per file; via the API you pass the format parameter with png, eps or pdf. EPS and PDF are vector files for print shops and office printers and are only generated live, sandbox mode returns PNG. GARAN-Label for print (EPS & PDF) →

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 →