EUlabel Documentation
Developer infrastructure for Digital Product Passports, EU digital labels, and GS1 Digital Link resolvers.
Build compliant Digital Product Passports with simple API calls. EUlabel handles the GS1 resolver, structured data, QR codes, and regulatory compliance — so you can focus on your product.
Early access — EUlabel is in active development. These docs are evolving quickly. If you need a walkthrough or notice something missing, open an issue on GitHub.
Phase 1: Wine e-labels — EUlabel currently supports wine e-labels under EU Regulation 2021/2117. Textile, battery, food, and electronics DPP support is on the roadmap. See Sector Timelines for details.
Start building
Quickstart
Create your first Digital Product Passport in 5 minutes
Get API keys
Generate test and production API keys
Try the Sandbox
Explore the API interactively without writing code
API Reference
Browse the complete REST API for products, passports, and more
Explore by topic
Documentation
Guides, SDKs, integrations, and everything you need to build with EUlabel
Knowledge Base
Digital Product Passports, GS1 standards, and EU compliance concepts
Webhooks
Real-time event notifications for passport and scan events
Authentication
API key scopes, environments, and secure credential management
How it works
Create a passport
One call creates the product and passport together. Send your GTIN, product identity, and as much data as you have — partial data is accepted.
curl -X POST https://api.eulabel.eu/v1/passports \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{"gtin": "5601234567890", "name": "Quinta do Crasto Douro Red 2021", "brand": "Quinta do Crasto", "category": "wine", "data": {"productType": "wine", "ingredients": ["Grapes", "Sulphites"]}}'Enrich if needed
The API response includes a compliance object that lists missing fields with hints and documentation links. Send more data whenever you have it — subsequent calls merge fields into the existing passport.
Publish automatically
When all required fields are present, the passport status auto-promotes from draft to published. EUlabel generates a GS1-conformant QR code that resolves to the Digital Product Passport. Consumers scan it for ingredients and nutrition. Regulators get compliance data. Recyclers see material composition.
Popular resources
Wine E-Label Compliance
Create a fully compliant EU wine e-label with ingredients, nutrition, and allergens
TypeScript SDK
Type-safe client library with auto-completion
Products API
Create, update, list, and manage products
The Resolver
How one QR scan reaches different audiences