Skip to main content
GET
Validate a GS1 Digital Link URI against the specification

Query Parameters

uri
string
required

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

Required string length: 1 - 4096

Response

200 - application/json

OK

Full conformance report for a candidate Digital Link URI.

uri
string
required

The input URI, echoed back unchanged.

is_conformant
boolean
required

True when the URI carries no error-severity issues. Warnings do not affect this flag.

issues
DigitalLinkIssueOut · object[]

Every issue found, errors and warnings together, in the order the validator produced them.

scheme
string | null

URI scheme, or null when the input could not be split.

Example:

"https"

host
string | null

URI host, or null when the input could not be split.

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, in path order.

data_attributes
ParsedDataAttributeOut · object[]

Data attributes found on the query string.

canonical_path
string | null

The spec-canonical path for this identifier set, or null when no primary AI was recognised.