Skip to content

Get language settings

API v2 is in public beta: endpoints and fields can change before general availability. See the changelog

GET/account/languages

Costs 1 rate-limit point · Rate limits

The shop's languages: default_locale (the language alerts and the signup widget use), app_locale (the dashboard language), whether multi-language support and translated product titles are on, and, when multi-language is on, the locales published in Shopify.

published_locales is only in the response when multi_language_enabled is true; it is then read live from Shopify and left out if Shopify can't be reached. Change app_locale, multi_language_enabled and product_translations_enabled with PATCH /account/languages. default_locale is changed only by POST /account/languages/reset_locale, which also resets that language's alert copy.

Also searched aslanguagesalert languagedefault languagedashboard languagemulti languagestore locales

Returns

  • default_localestring
    Example: string
  • app_localestring
    Example: string
  • multi_language_enabledboolean
    Example: true
  • product_translations_enabledboolean
    Example: true

Errors

404
not_found

The path is valid but nothing with that id exists in this store.

422
validation_failed

The request failed validation.

Any request can also fail with auth_invalid (401) or rate_limited (429).

Every error has the same shape: see Errors and the list of error codes.

GET/account/languages
curl "https://app.stoqapp.com/api/v2/external/account/languages" \
  -H "X-Auth-Token: $STOQ_API_KEY"
Response
{
  "default_locale": "string",
  "app_locale": "string",
  "multi_language_enabled": true,
  "product_translations_enabled": true
}