---
title: "Get migration state for a tenant"
method: GET
path: "/network-services/v1/airmatch-state"
tags: ["AirMatch"]
---

# Get migration state for a tenant

`GET /network-services/v1/airmatch-state`

Retrieve the current migration state for a given tenant

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Migration state retrieved successfully

- MigrationState — Paginated list response for migration state records.
  - `id` string, required
  - `type` string, required
  - `count` integer, required — Total number of migration state records returned
  - `items` object[], required
    - `id` string, required
    - `type` string, required
    - `tenantId` string — The tenant identifier
    - `migrationState` 'Tran-Begin' | 'PE-Enable' | 'PE-Finalize' | 'T-Enable' | 'PE-Direct' | 'E-Enable' | 'PE-UD' | 'PE-SD' — Current migration state
    - `migrationUpdatedTimestamp` integer — Unix timestamp of last update
    - `readyStatus` string — Migration readiness status
    - `readyReason` string — Additional details for the readiness status

## Other responses

- `400` — Bad Request. Validation errors in the request body or parameters, or invalid parameters for the specific device.
- `401` — Unauthorized. Authentication credentials are required or invalid.
- `403` — Forbidden request. The client does not have access rights to the content.
- `404` — Requested resource was not found.
- `429` — Too Many Requests. The user has sent too many requests in a given amount of time.
- `500` — Internal Server Error. An unexpected error occurred on the server.

---

[API](https://skmtc.net/arubanetworks/apis/authorization.md) · [All operations](https://skmtc.net/arubanetworks/apis/authorization/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arubanetworks/authorization/versions/74c95058b11f/schema)