---
title: "Get a Deployment Migration"
method: GET
path: "/groups/{groupId}/apps/{appId}/deployment_migration"
tags: ["deploy"]
---

# Get a Deployment Migration

`GET /groups/{groupId}/apps/{appId}/deployment_migration`

Get metadata and status for the current deployment migration, if one exists.

## Response `200`

Ok

- DeploymentMigration
  - `status` 'started' | 'downtime' | 'enabling_event_subscriptions' | 'cleanup' | 'successful' | 'failed'
  - `message` string — A description of the current migration status.
  - `updated_at` string — A timestamp of the most recent update to the deployment migration.
  - `from` AppDeploymentSettings
    - `deployment_model` 'GLOBAL' | 'LOCAL' — An application [deployment model](https://www.mongodb.com/docs/atlas/app-services/apps/deployment-models-and-regions/#deployment-models).
    - `provider_region` union
      - 'aws-us-east-1' | 'aws-us-west-2' | 'aws-us-east-2' | 'aws-eu-central-1' | 'aws-eu-west-1' | 'aws-eu-west-2' | 'aws-ap-southeast-1' | 'aws-ap-southeast-2' | 'aws-ap-south-1' | 'aws-sa-east-1'
      - 'azure-eastus2' | 'azure-westus' | 'azure-westeurope' | 'azure-eastasia' | 'azure-southeastasia'
      - 'gcp-us-central1' | 'gcp-us-east4' | 'gcp-us-west1' | 'gcp-europe-west1' | 'gcp-asia-south1'
  - `to` AppDeploymentSettings
    - `deployment_model` 'GLOBAL' | 'LOCAL' — An application [deployment model](https://www.mongodb.com/docs/atlas/app-services/apps/deployment-models-and-regions/#deployment-models).
    - `provider_region` union
      - 'aws-us-east-1' | 'aws-us-west-2' | 'aws-us-east-2' | 'aws-eu-central-1' | 'aws-eu-west-1' | 'aws-eu-west-2' | 'aws-ap-southeast-1' | 'aws-ap-southeast-2' | 'aws-ap-south-1' | 'aws-sa-east-1'
      - 'azure-eastus2' | 'azure-westus' | 'azure-westeurope' | 'azure-eastasia' | 'azure-southeastasia'
      - 'gcp-us-central1' | 'gcp-us-east4' | 'gcp-us-west1' | 'gcp-europe-west1' | 'gcp-asia-south1'

## Other responses

- `404` — App not found

---

[API](https://skmtc.net/mongodb/apis/mongodb-atlas-app-services-admin-api.md) · [All operations](https://skmtc.net/mongodb/apis/mongodb-atlas-app-services-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mongodb/mongodb-atlas-app-services-admin-api/revisions/1365ab72bc03/schema)