---
title: Migration API
description: >-
  Migrate existing app subscriptions that don't map automatically to Shopify App
  Pricing plans.
source_url:
  html: >-
    https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing/migration-api
  md: >-
    https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing/migration-api.md
---

# Migration API

The Migration API will move existing subscriptions to Shopify App Pricing when they can't migrate through the plan setup flow. Use it for subscriptions that don't map cleanly to one of your new plans, such as usage-based subscriptions or subscriptions whose current price doesn't match a plan you've created.

**Coming soon:**

The Migration API isn't available yet. This page describes what the API will do so that you can plan ahead. Setup steps and reference documentation will be added when the API is released.

***

## When to use the Migration API

The [plan setup flow](https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing/migrating-to-shopify-app-pricing) moves subscriptions that map directly to a Shopify App Pricing plan, where the current price and billing terms match a plan that you've prepared.

Some subscriptions can't move that way:

* **Usage-based subscriptions**, which bill on metered usage rather than a fixed recurring price.
* **Price mismatches**, where a subscription's current price doesn't match any of your Shopify App Pricing plans.

The Migration API will let you move these remaining subscriptions to Shopify App Pricing. Until it's available, these subscriptions keep billing as usual on their current plans, and you don't need to take any action.

***

## Related

* [Shopify App Pricing](https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing)
* [Migrate to Shopify App Pricing](https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing/migrating-to-shopify-app-pricing)

***