---
title: "Get migration status of a bdb in the cluster"
method: GET
path: "/v1/migrations/{uid}"
tags: ["Migrations"]
---

# Get migration status of a bdb in the cluster

`GET /v1/migrations/{uid}`

Migration status of a bdb in the cluster

## Path parameters

- `uid` integer, required

## Response `200`

migration information

- MigrationResponse — Response wrapper for migration endpoint
  - `migration` Migration — Object structure for migration status.
    - `error` MigrationError — Error information for migration operations
      - `error_code` string, nullable — Error code identifying the specific error
      - `message` string, nullable — Human-readable error message
      - `timestamp` string, date-time, nullable — Timestamp when the error occurred
    - `flush_counter` integer, nullable — How many times syncer had to restart.
    - `lag` integer, nullable — Lag in milliseconds between source and destination (while synced).
    - `rdb_size` integer, nullable — Number of source bytes.
    - `rdb_transferred` integer, nullable — Number of source bytes transferred.
    - `run_id` string, nullable — Syncer run id.
    - `source_shards` SourceShard[]
      - `replication_id` string — Replication id
      - `replication_offset` integer — Replication offset
    - `status` string, nullable — Sync status of this source.

## Other responses

- `403` — Forbidden
- `404` — Not Found

## Changes

- **2026-07-28** `c85fee8cf0f6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/redis/apis/redis-software-rest-api/changes/v1/migrations/:uid/get.md)

---

[API](https://skmtc.dev/redis/apis/redis-software-rest-api.md) · [All operations](https://skmtc.dev/redis/apis/redis-software-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redis/redis-software-rest-api/revisions/caec2005b95b/schema)