---
title: "List migrations"
method: GET
path: "/plans/{plan_id}/migrations"
tags: ["Plan"]
---

# List migrations

`GET /plans/{plan_id}/migrations`

This endpoint returns a list of all migrations for a plan.
The list of migrations is ordered starting from the most recently created migration.
The response also includes pagination_metadata, which lets the caller retrieve the next page of results if they exist.

## Path parameters

- `plan_id` string, required

## Query parameters

- `limit` integer — The number of items to fetch. Defaults to 20.
- `cursor` string, nullable — Cursor for pagination. This can be populated by the `next_cursor` value returned from the initial request.

## Response `200`

OK

- PlanVersionChanges
  - `data` PlanVersionChange[], required
    - `id` string, required — Unique identifier for this plan version change.
    - `plan_id` string, required — The ID of the plan being migrated.
    - `effective_time` union, required — When the migration takes effect. Can be a specific date/time, or 'end_of_term' when scheduled to be at the end of the current billing period.
      - string, date
      - string, date-time
      - 'end_of_term'
    - `status` 'not_started' | 'in_progress' | 'completed' | 'action_needed' | 'canceled', required — Current status of the migration: 'not_started', 'in_progress', 'completed', 'action_needed', or 'canceled'.
  - `pagination_metadata` PaginationMetadata, required
    - `has_more` boolean, required
    - `next_cursor` string, nullable, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict
- `413` — Content Too Large
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/orbcorp/apis/api-reference.md) · [All operations](https://skmtc.dev/orbcorp/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/orbcorp/api-reference/revisions/2580a0ee8d4c/schema)