---
title: "GET /migrations"
method: GET
path: "/migrations"
---

# GET /migrations

`GET /migrations`

Gets a list of migrations between Amazon Lex V1 and Amazon Lex V2.

## Query parameters

- `sortByAttribute` 'V1_BOT_NAME' | 'MIGRATION_DATE_TIME'
- `sortByOrder` 'ASCENDING' | 'DESCENDING'
- `v1BotNameContains` string
- `migrationStatusEquals` 'IN_PROGRESS' | 'COMPLETED' | 'FAILED'
- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- GetMigrationsResponse
  - `migrationSummaries` MigrationSummary[] — An array of summaries for migrations from Amazon Lex V1 to Amazon Lex V2. To see details of the migration, use the <code>migrationId</code> from the summary in a call to the operation.
    - `migrationId` string — The unique identifier that Amazon Lex assigned to the migration.
    - `v1BotName` string — The name of the Amazon Lex V1 bot that is the source of the migration.
    - `v1BotVersion` string — The version of the Amazon Lex V1 bot that is the source of the migration.
    - `v1BotLocale` 'de-DE' | 'en-AU' | 'en-GB' | 'en-IN' | 'en-US' | 'es-419' | 'es-ES' | 'es-US' | 'fr-FR' | 'fr-CA' | 'it-IT' | 'ja-JP' | 'ko-KR' — The locale of the Amazon Lex V1 bot that is the source of the migration.
    - `v2BotId` string — The unique identifier of the Amazon Lex V2 that is the destination of the migration.
    - `v2BotRole` string — The IAM role that Amazon Lex uses to run the Amazon Lex V2 bot.
    - `migrationStatus` 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' — The status of the operation. When the status is <code>COMPLETE</code> the bot is available in Amazon Lex V2. There may be alerts and warnings that need to be resolved to complete the migration.
    - `migrationStrategy` 'CREATE_NEW' | 'UPDATE_EXISTING' — The strategy used to conduct the migration.
    - `migrationTimestamp` string, date-time — The date and time that the migration started.
  - `nextToken` string — If the response is truncated, it includes a pagination token that you can specify in your next request to fetch the next page of migrations.

## Other responses

- `480` — LimitExceededException
- `481` — InternalFailureException
- `482` — BadRequestException

---

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