Developers

Product identity as an API call.

Create products, publish passports and register items from your own systems. Products in a project also appear in the dashboard.

Get an API key Read the docs

Quickstart

From key to registered unit.

Create an account and a project for your sector, then a project API key in that project's settings. Products created with that key appear in the dashboard. Put your own GTIN in the sample. This partial sample saves a draft, and the link opens a passport once every mandatory field is valid. Step 2 needs the product's internalId from GET /v1/products.

1. Save the passport · POST /v1/passports

{
  "gtin": "YOUR_GTIN",
  "name": "Voltaic VX-48-900 e-bike battery",
  "brand": "Voltaic",
  "category": "battery",
  "data": {
    "productType": "battery",
    "category": "lmt",
    "identity": {
      "manufacturerName": "Voltaic Energy Systems GmbH",
      "modelIdentifier": "VX-48-900",
      "chemistry": "NMC",
      "capacityAh": 18.8,
      "weightKg": 4.6,
      "rechargeable": true
    }
  }
}

2. Register a unit · POST /v1/products/{id}/items

curl -X POST \
  "https://api.eulabel.eu/v1/products/$PRODUCT_ID/items" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serialNumber": "VX48-2609-000117",
    "lotNumber": "L2609-A",
    "lifecycleStatus": "original"
  }'

3. Scan it once published

https://eulabel.eu/01/YOUR_GTIN/21/VX48-2609-000117

The API surface

What you can do today.

Products: Create and import products, with GTIN validation.
Passports: Publish, version and withdraw, with per-field validation.
Items: Register serial numbers and record lifecycle events.
Profiles: Read each sector's field catalog as JSON.
Access grants: Issue and revoke tokens for restricted audiences.
QR codes and domains: Generate codes and verify custom domains.

For agents too

Docs that machines can read.

Every docs page has a markdown version, and we publish llms.txt and llms-full.txt, so your agents work from the source.

Start with one product.

Early access is free and open to producers in all four sectors. Your QR codes keep working as the rules change.

Create a free account