Skip to main content
GET
Parse a GS1 Digital Link URI into its Application Identifiers

Query Parameters

uri
string
required

The GS1 Digital Link URI to decompose. Example: https://id.gs1.org/01/09506000164908/10/LOT1?17=261231

Required string length: 1 - 4096

Response

200 - application/json

OK

Structured decomposition of a URI, without the conformance grading.

The same engine backs this and /validate; this is the projection for callers who want "what AIs are in here" and do not need the issue list.

uri
string
required

The input URI, echoed back unchanged.

is_conformant
boolean
required

Whether the URI is spec-conformant. Call /validate for the reasons.

scheme
string | null

URI scheme.

Example:

"https"

host
string | null

URI host.

Example:

"id.gs1.org"

primary
ParsedAIOut · object | null

The primary identifier AI, or null when none was recognised.

Example:
qualifiers
ParsedAIOut · object[]

Qualifier AIs found in the path.

data_attributes
ParsedDataAttributeOut · object[]

Data attributes found on the query string.

ai_map
Ai Map · object

Flat {ai_code: value} map of every AI found, for callers that want one lookup table.

canonical_path
string | null

The spec-canonical path for this identifier set.