---
title: "Move packs and cards between this fan's wallets"
method: POST
path: "/api/inventory/transfers"
tags: ["Collectibles and packs"]
---

# Move packs and cards between this fan's wallets

`POST /api/inventory/transfers`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/inventory/transfers`
- Auth: HTTP bearer

Signed-in fan. Both wallets must be linked to the caller and different. Items are pack_unopened, pack_opened, or card (quantity or serial), at most 50, all-or-nothing. transferId is a UUID; a replay returns the stored lines and skips PIN verification. When requirePinForInventoryMove is enabled, a 6-digit pin verifies the source wallet before a non-replay move; the PIN is not stored or included in replay matching. Opened packs move independently of their cards. Writes through InventoryCustody and the InventoryTransfer ledger (#940, #941). Off with 404 FEATURE_DISABLED unless INVENTORY_TRANSFERS_ENABLED is true. Database custody settles immediately. On-chain custody is not implemented and returns 503 CUSTODY_UNAVAILABLE.

## Request body

- object
  - `transferId` string, uuid, required
  - `fromWallet` string, required
  - `toWallet` string, required
  - `toBinderId` string
  - `pin` string: Six-digit source-wallet PIN; required only when requirePinForInventoryMove is enabled.
  - `clientVersion` string
  - `items` object[], required
    - `type` 'pack_unopened' | 'pack_opened' | 'card', required
    - `ref` string, required
    - `qty` integer
    - `serial` string
    - `fromBinderId` string

## Response `200`

Settled move. replayed is true when transferId was already stored.

- object
  - `success` true, required
  - `data` object, required
    - `transferId` string, uuid, required
    - `status` 'settled', required
    - `replayed` boolean, required
    - `results` object[], required
    - `counts` object, required
      - `packs` integer, required
      - `cards` integer, required
      - `items` integer, required

## Other responses

- `400`: INVALID_PIN (wrong wallet PIN), VALIDATION_ERROR, SAME_WALLET, TOO_MANY_ITEMS, or PACK_PAYMENT_PENDING. A required wallet PIN that needs reset includes requiresPinReset: true.
- `401`: UNAUTHORIZED
- `403`: WALLET_NOT_LINKED — a wallet is not linked to this fan; PIN_REQUIRED — enter the source wallet PIN
- `404`: FEATURE_DISABLED or NOT_FOUND
- `409`: ITEM_LISTED, ITEM_OPENING, ITEM_PENDING_SORT, ITEM_NOT_IN_WALLET, IDEMPOTENCY_KEY_CONFLICT, PACK_ALREADY_OPENED, ITEM_STATE, INSUFFICIENT_QUANTITY, or WALLET_MISMATCH
- `429`: RATE_LIMITED — PIN verification quota or INVENTORY_TRANSFER_RATELIMIT_ENABLED transfer quota
- `500`: INTERNAL_ERROR
- `503`: CUSTODY_UNAVAILABLE — on-chain custody is not implemented; RATE_LIMITER_UNAVAILABLE — fail-closed PIN limiter

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/inventory/transfers/post.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
