---
title: "Transfer Player Subscription"
method: POST
path: "/v1/players/{player_id}/subscriptions/{subscription_id}/transfer"
tags: ["Players' Subscriptions"]
---

# Transfer Player Subscription

`POST /v1/players/{player_id}/subscriptions/{subscription_id}/transfer`

Transfer a player's subscription to another player in the same game, keeping the plan, billing schedule and saved payment method.

## Path parameters

- `player_id` string, required
- `subscription_id` string, required

## Request body

- SubscriptionTransferRequest
  - `new_player_id` string, required — Player ID to transfer the subscription to.

## Response `200`

Subscription transferred to the target player.

- TransferredSubscription
  - `id` string, required — New subscription ID created for the target player.
  - `status` 'trial' | 'active' | 'grace' | 'canceled' | 'locked' | 'ended' | 'expired' | 'paused' | 'pending', required

## Other responses

- `204` — Subscription changed concurrently, retry later.
- `422` — Validation Error

---

[API](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api.md) · [All operations](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aghanim/aghanim-server-to-server-api/revisions/2fecf8a6aa0b/schema)