---
title: "Get a Capability Localization by Locale"
method: GET
path: "/capabilities/{capabilityId}/{capabilityVersion}/i18n/{locale}"
tags: ["Capabilities"]
---

# Get a Capability Localization by Locale

`GET /capabilities/{capabilityId}/{capabilityVersion}/i18n/{locale}`

## Request

- Base URL: `https://api.smartthings.com/v1`
- URL: `https://api.smartthings.com/v1/capabilities/{capabilityId}/{capabilityVersion}/i18n/{locale}`
- Auth: OAuth 2
  - Implicit: `https://auth-global.api.smartthings.com`
- TypeScript: <https://skmtc.dev/smartthings/apis/smartthings-api/docs/capabilities/:capabilityId/:capabilityVersion/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 Capability.
A `locale` is the abbreviated, internationalization code for the requested language.

## Query parameters

- `manufacturerName` string
- `presentationId` string, required

## Response `200`

successful return of a Capability localization

- CapabilityLocalization
  - `tag` string, required: The tag of the locale as defined in [RFC bcp47](http://www.rfc-editor.org/rfc/bcp/bcp47.txt).
  - `label` string: A localized label for the capability
  - `description` string: A localized description of the capability
  - `attributes` object: Map of attribute name to localizations
  - `commands` object: Map of command name to localizations

## Other responses

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

## Changes

- **2026-01-22** `6acc46f51053`: 1 breaking, 1 info
  - added the new required `query` request parameter `presentationId`
  - added the new optional `query` request parameter `manufacturerName`

[Operation history](https://skmtc.dev/smartthings/apis/smartthings-api/changes/capabilities/:capabilityId/:capabilityVersion/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)