Storefront Localization

Storefront

Storefront Localization groups 1 operation on the storefront tier.

Storefront tier. Reachable anonymously; a public vnstss_ token may be sent to identify the storefront.

GET

/api/{version}/localization

AuthenticationAnonymousStorefront tier. Reachable anonymously; a public vnstss_ token may be sent to identify the storefront.

Responses

200StorefrontLocalizationResponseOK

curl -X GET \
  'https://<your-shop-domain>/api/2026-04-01/localization' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer vnstss_<token>'

Response200example shape

{
  "localization": {
    "active": "string",
    "default": "string",
    "available": [
      {
        "code": "string",
        "name": "string",
        "default": true
      }
    ]
  }
}

Schemas

StorefrontLanguageDto

A single published locale. code is the value to send back as ?lang=/?locale= or Accept-Language; name is the language's own endonym, ready to render in the switcher without a client-side lookup table.

codestringnullable
namestringnullable
defaultboolean

StorefrontLocalizationDto

Storefront representation of the shop's language set. active is the locale the current request resolved to (also echoed in the Content-Language header) and always appears in available, so a switcher can render the options and mark the selected one from this read alone.

activestringnullable
defaultstringnullable
availableStorefrontLanguageDto[]nullable

StorefrontLocalizationResponse

Envelope returned by GET /localization.

localizationStorefrontLocalizationDto