Skip to main content
GET
The path is an uncompressed GS1 Digital Link URI: the GTIN, optionally followed by its key qualifiers.
The qualifiers keep this order, and any of them may be left out. The third-party serialised extension (235) stands alone. Other GS1 Application Identifiers, such as the expiry date (17), go in the query string. A trailing slash is ignored. No authentication is needed. CORS, caching, error bodies and the linkset formats are described in the Overview.

​
Key qualifiers

The key qualifiers are optional path segments after the GTIN, each an Application Identifier followed by its value: Qualifier values use GS1 character set 82: letters, digits and !"%&'()*+,-./:;<=>?_. Percent-encode the characters that cannot appear in a URL path segment as they are, for example / as %2F. linkType takes:
  • a GS1 link type the product has a page for, as a CURIE (gs1:certificationInfo) or as its full URI (https://ref.gs1.org/voc/certificationInfo, or the older https://gs1.org/voc/certificationInfo and http://gs1.org/voc/certificationInfo),
  • the name of one of the product’s pages, as it appears in the product page URL,
  • gs1:defaultLink, the default page in the product’s default language,
  • gs1:defaultLinkMulti, the default page in the scanner’s language,
  • linkset, to get the linkset instead of a redirect.
The query string of the scan is passed on to the redirect target as it was sent, in the same order and with repeated names. The resolver appends 10, 21 and 17 (lot, serial and expiry date) when they are in the link but not in the query, so the product page opens the version pinned to them in the dashboard. A request is 400 when:
  • the GTIN is not 8, 12, 13 or 14 digits, or its check digit is wrong,
  • a qualifier has no value,
  • an Application Identifier in the path is not 22, 10, 21 or 235,
  • the qualifiers are out of order, or 235 is combined with another one,
  • a value is too long or has a character outside character set 82,
  • a qualifier is repeated with a different value,
  • the path is not valid percent-encoding.

​
Linkset contents

The linkset has one entry, for the scanned link:
  • anchor is the uncompressed GS1 Digital Link on the scanned host, with its key qualifiers and without the query.
  • description is the product name in its default language. Left out when the product has none.
  • https://ref.gs1.org/voc/defaultLink holds one link: the default page in the default language, with href and title only.
  • https://ref.gs1.org/voc/defaultLinkMulti holds the default page in every language it is published in.
  • Every other key is the full URI of a link type, holding that page in every language it is published in. title is the page’s name in that language, hreflang the language, and type is always text/html.
Links point to the brand’s custom domain when it has one, and to thingidentity.com from gtin.at. When the scan carries a lot, serial or expiry date, in the path or in the query, every href carries it too, so each link opens the same pinned version as the scan.

Headers

​
Accept
string

application/linkset+json returns the linkset instead of a redirect. With linkType=linkset, application/json, application/ld+json and text/html choose its format. Also chooses between JSON error bodies and an HTML error page.

​
Accept-Language
string

The scanner's languages. The redirect opens the first one the product is published in.

Path Parameters

​
gtin
string
required

The GTIN in 14 digits, with a valid check digit. GTIN-8, GTIN-12 and GTIN-13 are accepted too and read as the 14-digit GTIN padded with leading zeros.

Query Parameters

​
linkType
string

The page to open instead of the default one. The name is read in any case (linktype too); the value is case-sensitive. A value that matches no page returns 404.

Response

The linkset, when requested.