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 8020
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
Extension identifying an internal location within a GLN
414
8011 CPID serial number
Serial number of a component / part
8010
8019 Service Relation Instance Number (SRIN)
Instance of a service relation
8017, 8018
8020 Payment reference number
Reference number of a payment slip, mandatory after AI (415)
415

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)
716 NHRN — Approved Invented Code (AIC)
717 NHRN — Single Registration Number (SRN)
3200 Net weight (lb)
3906 Amount payable (single monetary area)
3907 Amount payable (single monetary area)
3908 Amount payable (single monetary area)
3909 Amount payable (single monetary area)
3916 Amount payable with ISO currency code
3917 Amount payable with ISO currency code
3918 Amount payable with ISO currency code
3919 Amount payable with ISO currency code
3920 Amount payable
3926 Amount payable per unit of measure
3927 Amount payable per unit of measure
3928 Amount payable per unit of measure
3929 Amount payable per unit of measure
3936 Amount payable per unit with ISO currency code
3937 Amount payable per unit with ISO currency code
3938 Amount payable per unit with ISO currency code
3939 Amount payable per unit with ISO currency code
3940 Percentage discount of a coupon
3941 Percentage discount of a coupon
3942 Percentage discount of a coupon
3943 Percentage discount of a coupon
3954 Amount payable per unit of measure (ISO currency)
3955 Amount payable per unit of measure (ISO currency)
4309 Ship-to geographic location
4330 Maximum temperature (°F)
4331 Maximum temperature (°C)
4332 Minimum temperature (°F)
4333 Minimum temperature (°C)
7003 Expiration date and time
7011 Test by date (YYMMDD[hhmm])
7041 UN freight unit type
7240 Protocol identifier
7241 AIDC media type
7242 Version control number (VCN)
7250 Date of birth (YYYYMMDD)
7251 Date and time of birth
7252 Biological sex
7253 Family name of person
7254 Given name of person
7255 Name suffix of person
7256 Full name of person
7257 Address of person
7258 Baby birth sequence indicator
7259 Baby of family name
8030 Digital signature (DigSig)
8040 IMEI
8041 IMEI (second)
8042 eSIM identifier
8043 pSIM identifier