---
title: "Get a Preference Localization by Locale"
method: GET
path: "/preferences/{preferenceId}/i18n/{locale}"
tags: ["Preferences"]
---

# Get a Preference Localization by Locale

`GET /preferences/{preferenceId}/i18n/{locale}`

## Request

- Base URL: `https://api.smartthings.com/v1`
- URL: `https://api.smartthings.com/v1/preferences/{preferenceId}/i18n/{locale}`
- Auth: OAuth 2
  - Implicit: `https://auth-global.api.smartthings.com`
- TypeScript: <https://skmtc.dev/smartthings/apis/smartthings-api/docs/preferences/:preferenceId/i18n/:locale/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve translated values in a desired language (i.e. locale) for a Preference.
The `locale` is the abbreviated internationalization code associated with the language.

## Path parameters

- `preferenceId` string, required
- `locale` string, required

## Headers

- `Authorization` string, string, required

## Response `200`

Successful retrieval of a Preference Localization

- PreferenceLocalization
  - `tag` string, required: The tag of the locale as defined in [RFC bcp47](http://www.rfc-editor.org/rfc/bcp/bcp47.txt).
  - `label` string, required: A localized label for the Preference
  - `description` string: A localized description of the Preference
  - `options` object: Map of an option name to localizations. Options can only be provided to localize Enumeration type Preferences, and are required for Enumerations. The number of options in a Preference Localization must match the number of options in the Preference.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too many requests
- `default`: Unexpected error

## Changes

- **2023-11-27** `e8dd260a33ec`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartthings/apis/smartthings-api/changes/preferences/:preferenceId/i18n/:locale/get.md)

---

[API](https://skmtc.dev/smartthings/apis/smartthings-api.md) - [All operations](https://skmtc.dev/smartthings/apis/smartthings-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartthings/apis/smartthings-api/revisions/2788a4236800?raw)