Get Storefront context

GET /context

Load the Shopify Storefront API URL and public token associated with this installation. This route requires Headless SDK (sdkEnabled and a stored public Storefront token). Use those credentials to query product data/settings or perform Storefront cart operations.

API-only integrations do not call this route. They receive HTTP 403 with code SDK_NOT_CONFIGURED. Load the catalog from your own storefront or Shopify admin instead. See Connect Headless API.

Request

Authentication: X-Antla-SDK-Key: YOUR_ANTLA_SDK_KEY.

Uses the shared IP rate limit. See Errors and rate limits.

No query parameters or request body are required.

Example request

curl --fail-with-body \
  "https://app-antla.com/api/headless/context" \
  -H "X-Antla-SDK-Key: YOUR_ANTLA_SDK_KEY"

Successful response

HTTP 200, JSON envelope:

{
  "data": {
    "storefront": {
      "apiUrl": "https://store.myshopify.com/api/2026-07/graphql.json",
      "publicToken": "public-storefront-token"
    }
  }
}

The private Storefront token is never returned. Use apiUrl as returned. The current Storefront API version in that URL is 2026-07.

This is a bootstrap response, not the complete product or modal settings. Those are loaded separately from Shopify. Do not send the Antla SDK key as the Shopify Storefront token.

Errors

401 when the key is missing, unknown, or disconnected. 403 SDK_NOT_CONFIGURED when Headless SDK is not connected or the public Storefront token is missing. 429 for the shared IP limit. 500 for a server failure. See Errors and rate limits.