Skip to main content
Transfers move value between identities on Whop. They are used for account-to-account money movement, user payouts inside Whop, crypto transfers, and claim links depending on the destination type. Use the Transfers API to create a transfer, list previous transfers, and retrieve a transfer by ID when reconciling money movement between accounts or users.

​
Endpoints

EndpointRequest
List TransfersGET /transfers
Create TransferPOST /transfers
Retrieve TransferGET /transfers/{id}

​
Attributes

​
amount
number
required
Transfer amount.
​
created_at
string
required
When the transfer was created.
​
currency
string
required
Transfer currency.
​
destination
object
required
Account or user receiving funds.
​
destination_ledger_account_id
string
required
Destination ledger account ID.
​
fee_amount
number | null
Fee charged for the transfer.
​
id
string
required
Transfer ID.
​
metadata
object | null
Custom metadata attached to the transfer.
​
notes
string | null
Transfer note.
​
origin
object
required
Account or user sending funds.
​
origin_ledger_account_id
string
required
Source ledger account ID.
Transfer
{
	"amount": 50,
	"created_at": "2026-06-01T12:00:00Z",
	"currency": "usd",
	"destination": {
		"id": "user_xxxxxxxxxxxxx",
		"name": "Alex Rivera",
		"typename": "User",
		"username": "alex"
	},
	"destination_ledger_account_id": "la_destxxxxxxxx",
	"fee_amount": null,
	"id": "tr_xxxxxxxxxxxxx",
	"metadata": {
		"external_transfer_id": "transfer_123"
	},
	"notes": "Creator bonus",
	"origin": {
		"id": "biz_xxxxxxxxxxxxxx",
		"route": "pickaxe",
		"title": "Pickaxe",
		"typename": "Company"
	},
	"origin_ledger_account_id": "la_originxxxxxx"
}