---
title: "Get the list of Voyager migrations"
method: GET
path: "/migrations"
tags: ["voyager-info"]
---

# Get the list of Voyager migrations

`GET /migrations`

Get the list of Voyager migrations

## Query parameters

- `uuid` string, uuid
- `migration_phase` integer

## Response `200`

List of the Voyager migrations

- VoyagerMigrationsInfo — YB Voyager migrations Info
  - `migrations` VoyagerMigrationDetails[]
    - `migration_uuid` string, uuid
    - `migration_name` string
    - `migration_type` string
    - `migration_phase` integer
    - `invocation_sequence` integer
    - `source_db` object
      - `ip` string
      - `port` string
      - `engine` string
      - `version` string
      - `database` string
      - `schema` string
    - `voyager` object
      - `machine_ip` string
      - `os` string
      - `avail_disk_bytes` string
      - `export_dir` string
      - `exported_schema_location` string
    - `target_cluster` object
      - `ip` string
      - `port` string
      - `engine` string
      - `version` string
    - `complexity` string
    - `status` string
    - `progress` string
    - `invocation_timestamp` string
    - `start_timestamp` string

## Other responses

- `400` — API Error
- `500` — API Error

## Changes

> 45 revisions in range; 1 could not be searched.

- **2024-10-02** `5f7548725c7e` — 1 breaking, 2 warning, 11 info
  - the `migrations/items/source_db` response's property type/format changed from `string`/`` to `object`/`` for status `200`
  - removed the optional property `migrations/items/database_name` from the response with the `200` status
  - removed the optional property `migrations/items/schema_name` from the response with the `200` status
  - added the optional property `migrations/items/migration_type` to the response with the `200` status
  - …10 more
- **2023-09-01** `d2871a69bf4a` — 1 info
  - endpoint added
- **2022-06-13** `7856cb3301b2` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/yugabyte/apis/yugabyte-cloud/changes/migrations/get.md)

---

[API](https://skmtc.dev/yugabyte/apis/yugabyte-cloud.md) · [All operations](https://skmtc.dev/yugabyte/apis/yugabyte-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yugabyte/yugabyte-cloud/revisions/a851ee3a0a88/schema)