Data Formats
Linkset (RFC 9264)
Machine-discoverable link collections returned by the GS1-conformant resolver.
The EUlabel resolver returns machine-discoverable link collections when a client requests ?linkType=linkset or sends Accept: application/linkset+json.
What is a linkset?
A linkset is a structured collection of links associated with a product, defined by RFC 9264. Each link points to a different resource about the product (ingredient info, allergen data, nutrition, product page) with metadata describing the link type, language, and media type.
Example linkset response
{
"linkset": [
{
"anchor": "https://eulabel.eu/01/05601012012200",
"https://gs1.org/voc/pip": [
{
"href": "https://eulabel.eu/passport/prd_01F8ABC123",
"title": "Product Information Page",
"type": "text/html",
"hreflang": ["en", "pt"]
}
],
"https://gs1.org/voc/allergenInfo": [
{
"href": "https://api.eulabel.eu/v1/products/prd_01F8ABC123/passport?section=allergens",
"title": "Allergen Information",
"type": "application/json"
}
],
"https://gs1.org/voc/nutritionalInfo": [
{
"href": "https://api.eulabel.eu/v1/products/prd_01F8ABC123/passport?section=nutrition",
"title": "Nutrition Declaration",
"type": "application/json"
}
],
"https://gs1.org/voc/defaultLink": [
{
"href": "https://eulabel.eu/passport/prd_01F8ABC123",
"title": "Digital Product Passport",
"type": "text/html"
}
]
}
]
}Link attributes
| Attribute | Required | Description |
|---|---|---|
href | Yes | Target URL of the resource |
title | Yes | Human-readable title |
type | Recommended | Media type (e.g., text/html, application/ld+json) |
hreflang | Recommended | BCP 47 language tags |
Requesting a linkset
# Via query parameter
curl "https://eulabel.eu/01/05601012012200?linkType=linkset"
# Via Accept header
curl https://eulabel.eu/01/05601012012200 \
-H "Accept: application/linkset+json"The default link (gs1:defaultLink) is returned when no specific linkType is requested. Every product must have exactly one default link.