Skip to main content

Supported GS1 Application Identifiers

Every Application Identifier (AI) the Closient Digital Link resolver understands — the primary keys it resolves, the qualifier AIs permitted for each, and the data-attribute AIs it reads from the query string. These tables are generated directly from the resolver's own validation code, so they cannot drift from what the resolver actually does.

The resolver accepts the uncompressed GS1 Digital Link URI form — for example /01/{gtin}/10/{lot}/21/{serial} — with data attributes such as ?17={expiry} on the query string. The compressed Digital Link syntax is not yet supported.

Want proof instead of promises? See the daily GS1 conformance report — the official GS1 resolver test suite, run against this resolver every day.

Primary key identifiers

A Digital Link URI always starts with one of these primary key AIs. "Resolves" means the resolver routes the identifier to a live destination (redirect, linkset, or JSON-LD).

AI Name Resolution Length Check digit Permitted qualifiers
00 SSCC
Serial Shipping Container Code
Resolves 18 digits Yes
01 GTIN
Global Trade Item Number
Resolves 8, 12, 13, 14 digits Yes 10, 21, 22, 235
253 GDTI
Global Document Type Identifier
Resolves Variable No 21
255 GCN
Global Coupon Number
Resolves Variable No 21
401 GINC
Global Identification Number for Consignment
Resolves Variable No
402 GSIN
Global Shipment Identification Number
Resolves 17 digits Yes
414 GLN (Physical Location)
Global Location Number — physical location
Resolves 13 digits Yes 254
415 GLN (Invoicing Party)
Global Location Number — invoicing party
Resolves 13 digits Yes
417 GLN (Party)
Global Location Number — party
Resolves 13 digits Yes
8003 GRAI
Global Returnable Asset Identifier
Resolves Variable No 21
8004 GIAI
Global Individual Asset Identifier
Resolves Variable No
8006 ITIP
Individual Trade Item Piece
Resolves 18 digits Yes 10, 21, 22
8010 CPID
Component / Part Identifier
Resolves Variable No 8011
8013 GMN
Global Model Number
Resolves Variable No
8017 GSRN (Provider)
Global Service Relation Number — provider
Resolves 18 digits Yes 8019
8018 GSRN (Recipient)
Global Service Relation Number — recipient
Resolves 18 digits Yes 8019

All 16 primary key AIs resolve — the resolver routes each to a live destination (redirect, linkset, or JSON-LD). Identifiers that fail GS1 format validation return a structured 400 stating why, rather than failing silently.

Qualifier AIs

Qualifiers follow the primary key in the URI path (e.g. /01/{gtin}/10/{lot}). Per the GS1 Digital Link standard, each primary key permits only specific qualifiers.

AI Name Valid with primary key
10 Batch / Lot
Batch or lot number
01, 8006
21 Serial
Serial number
01, 253, 255, 8003, 8006
22 Consumer Product Variant (CPV)
Consumer product variant
01, 8006
235 TPX (Third Party Controlled, Serialised)
Third party controlled serialised extension
01
254 GLN extension component 414
8011 CPID serial number 8010
8019 Service Relation Instance Number (SRIN) 8017, 8018

Data-attribute AIs

Data attributes ride on the query string (e.g. ?17=261231&10=LOT42). The resolver surfaces these as supplementary information — they never change which product or entity the URI identifies.

AI Meaning
11 Production date (YYMMDD)
13 Packaging date (YYMMDD)
15 Best before date (YYMMDD)
16 Sell by date (YYMMDD)
17 Expiration date (YYMMDD)
30 Variable count of items
37 Count of trade items (n1..8)
240 Additional product identification
241 Customer part number
242 Made-to-order variation
243 Packaging component number
250 Secondary serial number
251 Reference to source entity
310n Net weight (kg), variable measure (n6)
311n Length / 1st dimension (m), variable measure (n6)
312n Width / diameter / 2nd dimension (m), variable measure (n6)
313n Height / depth / 3rd dimension (m), variable measure (n6)
314n Area (m²), variable measure (n6)
315n Net volume (l), variable measure (n6)
316n Net volume (m³), variable measure (n6)
3200 Net weight (lb)
3920 Amount payable
7003 Expiration date and time
8200 Extended packaging URL