---
title: "GET /bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/"
method: GET
path: "/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/"
---

# GET /bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/

`GET /bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/`

Describes the settings that a bot has for a specific locale.

## Path parameters

- `botId` string, required
- `botVersion` string, required
- `localeId` string, required

## Response `200`

Success

- DescribeBotLocaleResponse
  - `botId` string — The identifier of the bot associated with the locale.
  - `botVersion` string — The identifier of the version of the bot associated with the locale.
  - `localeId` string — The unique identifier of the described locale.
  - `localeName` string — The name of the locale.
  - `description` string — The description of the locale.
  - `nluIntentConfidenceThreshold` number, double — The confidence threshold where Amazon Lex inserts the <code>AMAZON.FallbackIntent</code> and <code>AMAZON.KendraSearchIntent</code> intents in the list of possible intents for an utterance.
  - `voiceSettings` object — The Amazon Polly voice Amazon Lex uses for voice interaction with the user.
    - `voiceId` string, required — The identifier of the Amazon Polly voice to use.
    - `engine` 'standard' | 'neural' — <p>Indicates the type of Amazon Polly voice that Amazon Lex should use for voice interaction with the user. For more information, see the <a href="https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html#polly-SynthesizeSpeech-request-Engine"> <code>engine</code> parameter of the <code>SynthesizeSpeech</code> operation</a> in the <i>Amazon Polly developer guide</i>.</p> <p>If you do not specify a value, the default is <code>standard</code>.</p>
  - `intentsCount` integer — The number of intents defined for the locale.
  - `slotTypesCount` integer — The number of slot types defined for the locale.
  - `botLocaleStatus` 'Creating' | 'Building' | 'Built' | 'ReadyExpressTesting' | 'Failed' | 'Deleting' | 'NotBuilt' | 'Importing' | 'Processing' — The status of the bot. If the status is <code>Failed</code>, the reasons for the failure are listed in the <code>failureReasons</code> field.
  - `failureReasons` FailureReason[] — if <code>botLocaleStatus</code> is <code>Failed</code>, Amazon Lex explains why it failed to build the bot.
  - `creationDateTime` string, date-time — The date and time that the locale was created.
  - `lastUpdatedDateTime` string, date-time — The date and time that the locale was last updated.
  - `lastBuildSubmittedDateTime` string, date-time — The date and time that the locale was last submitted for building.
  - `botLocaleHistoryEvents` BotLocaleHistoryEvent[] — History of changes, such as when a locale is used in an alias, that have taken place for the locale.
    - `event` string, required — A description of the event that occurred.
    - `eventDate` string, date-time, required — A timestamp of the date and time that the event occurred.
  - `recommendedActions` RecommendedAction[] — Recommended actions to take to resolve an error in the <code>failureReasons</code> field.

## Other responses

- `480` — ThrottlingException
- `481` — ServiceQuotaExceededException
- `482` — ValidationException
- `483` — ResourceNotFoundException
- `484` — InternalServerException

---

[API](https://skmtc.net/aws/apis/models-lex-v2.md) · [All operations](https://skmtc.net/aws/apis/models-lex-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/models-lex-v2/versions/4ee1a1257ae7/schema)