Discover all the possibilities of the GOTO APIs

Resolution API

The resolution API contains the main endpoints used to retrieve the DigitalLink details of the scanned QR codes.

Authorization

These endpoints don't require any authorization as they are called by the customer devices.

Endpoints

GET /{digitalLink}

This is the main endpoint used to resolve Digital Links. The parameter is a catch all that parses the different AIs and resolves the best match based on the configured anchors.

Parameters

digitalLink: PATH REQUIRED The digital link value to be resolved. It can be either compressed, partially-compressed or decompressed as mentioned in the GS1 DL specification.
linkType: QUERY OPTIONAL The linkType to be resolved. If not specified, the resolver will return the default link(s) configred.

Response

Returns the links configured for the best match Anchor configured for this Digital Link.

Headers

Accept: The desired format of the response returned by the resolver. Accepted values are application/json, application/linkset+json and text/xml
Accept-Language: The ordered list of preferred languages for this request. This can influence the response from the resolver based on the configured links
X-Request-Date: Specifies the date to be used when resolving the DigitalLink. This can be any datetime in the past or future, shall be specified in ISO 8601 format.
X-Request-Tracking: If the value is bypass or notrack, the request will not be included in the insights summaries.

GET /.well-known/gs1resolver

The well-known endpoint to get the global configuration of the DigitalLink resolver, as per GS1 specification.

Parameters

No parameters for this request

Response

The resolver's configuration.

Headers

No specific header for this request

Insights API

The insights API allows to get the number of scans and the details of the response for any DigitalLink configured in the resolver.

Authorization

These endpoints require an API key specified in the X-Api-Key header.

Endpoints

GET /api/insights

Get the list of DigitalLinks resolved and the number of times they were resolved.

Parameters

No parameters for this endpoint

Response

Returns the list of DigitalLinks resolved in JSON format.

{
  "count": 1,
  "data": 
  [
    {
      "digitalLink": "/01/05414195535264",
      "scanCount": 1
    }
  ]
}

GET /api/insights/{DigitalLink}

This is the main endpoint used to resolve Digital Links. The parameter is a catch all that parses the different AIs and resolves the best match based on the configured anchors.

Parameters

digitalLink: PATH REQUIRED The digital link to get the insights from. It must be the decompressed value containing only primary key and qualifiers.

Response

The scans details of the specified DigitalLinks.

{
  "count": 1,
  "data": 
  [
    {
      "url": "https://id.goto.it.com/01/05414195535264?linkType=gs1:pip",
      "recordDate": "2026-07-25T11:24:15Z",
      "requestDate": "2026-07-25T11:24:14Z",
      "headers":
      {
        "acceptLanguage": "fr-BE;q=1, fr-FR; q=0.9, en;q=0.1",
        "accept" = "text/html"
      },
      "statusCode": 307,
      "linkCount": 1
    }
  ]
}

Headers

Accept: The desired format of the response returned by the resolver. Accepted values are application/json and text/xml
X-Request-Date: Specifies the date to be used when resolving the DigitalLink. This can be any datetime in the past or future, shall be specified in ISO 8601 format.
X-Request-Tracking: If the value is bypass or notrack, the request will not be included in the insights summaries.