---
title: "List Migration Runs"
method: GET
path: "/api/v1/migrations/{migration_id}/runs"
tags: ["migrations"]
---

# List Migration Runs

`GET /api/v1/migrations/{migration_id}/runs`

## Request

- Base URL: `https://api.mengi.cloud` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mengi.cloud/api/v1/migrations/{migration_id}/runs`
- Auth: none declared

Every run of a migration (initial + re-syncs), newest first.

## Path parameters

- `migration_id` string, uuid, required

## Response `200`

Successful Response

- MigrationRunListResponse
  - `runs` MigrationRunResponse[], required
    - `id` string, uuid, required
    - `migration_id` string, uuid, required
    - `trigger` 'initial' | 'manual' | 'scheduled', required
    - `status` 'pending' | 'installing_velero_source' | 'backing_up' | 'installing_velero_target' | 'restoring' | 'importing_workloads' | 'cleaning_up' | 'completed' | 'failed' | 'cancelled', required
    - `progress_message` string, nullable
    - `error_message` string, nullable
    - `backup_name` string, nullable
    - `restore_name` string, nullable
    - `backup_size_bytes` integer, nullable
    - `pvc_count` integer, nullable
    - `resource_count` integer, nullable
    - `started_at` string, date-time, required
    - `completed_at` string, date-time, nullable
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mengi/apis/mengi-cloud.md) · [All operations](https://skmtc.dev/mengi/apis/mengi-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/mengi/apis/mengi-cloud/revisions/4ae9b375cdbb?raw)