API Reference

The EUlabel API provides endpoints for managing products, digital passports, suppliers, and scan analytics. All endpoints follow a consistent design inspired by Stripe: simple, predictable, and well-documented.

Base URL

https://api.eulabel.eu/v1

Authentication

All requests require an API key in the Authorization header:

curl https://api.eulabel.eu/v1/products \
  -H "Authorization: Bearer sk_live_..."

See Authentication for details on API keys and scopes.

Request format

• Request bodies use JSON (Content-Type: application/json)
• All timestamps are ISO 8601 in UTC
• Identifiers are UUIDs

Error format

All errors return a consistent structure:

{
  "error": {
    "type": "validation_error",
    "message": "gtin is required",
    "code": "validation_error",
    "param": "gtin"
  }
}

Status codes

Endpoints