---
title: "Transfer subscription"
method: POST
path: "/subscriptions/{subscriptionId}/transfer"
---

# Transfer subscription

`POST /subscriptions/{subscriptionId}/transfer`

Use this endpoint to transfer [externally-managed subscriptions](https://developers.cleeng.com/docs/externally-managed-subscriptions) (EMS) - subscriptions whose life cycle is managed outside of Cleeng. <br><br>    Subscription is transferred if there is already an active subscription in Cleeng that belongs to a customer with a different email address. Then a new subscription is created for the "new customer" (the one using the new email address) and the subscription assigned to the "old customer" (the one using the old email address) is terminated. <br><br>  **Note:**  For subscription transfer [subscription resource payload](https://developers.cleeng.com/reference/create-subscription#response-description) should be returned in response with non-empty `replacedBy` property.

## Path parameters

- `subscriptionId` integer, required

## Headers

- `Content-Type` string

## Request body

- object
  - `customerId` integer — The identifier of Cleeng customer.

## Response `200`

200

- object
  - `subscriptionId` integer
  - `paymentDetailsId` unknown
  - `publisherId` integer
  - `customerId` integer
  - `status` string
  - `dateFrom` integer
  - `dateTo` integer
  - `nextPaymentAction` string
  - `nextPaymentActionDate` integer
  - `subscriptionExternalId` string
  - `offerId` string
  - `paymentCountry` string
  - `ipAddress` unknown
  - `inTrial` boolean
  - `couponCode` unknown
  - `pendingSwitchId` string
  - `externalProperties` object
  - `paymentMethodId` integer
  - `isExternallyManaged` boolean
  - `replacedBy` object
    - `subscriptionId` integer
    - `reason` string
    - `date` integer
  - `originatedFrom` object
    - `subscriptionId` integer
    - `reason` string
    - `date` integer
  - `source` string
  - `renewalCycle` object
    - `completed` integer
    - `unit` string
    - `amount` integer
  - `terminationType` unknown

## Other responses

- `400` — 400
- `404` — 404
- `422` — 422

---

[API](https://skmtc.net/cleeng/apis/mediastore-api.md) · [All operations](https://skmtc.net/cleeng/apis/mediastore-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cleeng/mediastore-api/versions/00cbfe7998a4/schema)