Transfers

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

Endpoint	Request
List Transfers	GET `/transfers`
Create Transfer	POST `/transfers`
Retrieve Transfer	GET `/transfers/{id}`
List Transfer Recipients	GET `/transfers/recipients`

Attributes

string

required

Transfer ID.

number

required

Transfer amount.

string

required

When the transfer was created.

object | null

required

The user who initiated the transfer, such as the team member who sent a manual payout. Null if the creator is unavailable.

Properties

string

required

User ID.

string | null

User display name.

string

required

User’s username.

string

required

Transfer currency.

object

required

Account or user receiving funds.

string

required

Destination ledger account ID.

number | null

Fee charged for the transfer.

object | null

Custom metadata attached to the transfer.

string | null

Transfer note.

string

required

The object type. Discriminates the create response from a send or a claim link.

object

required

Account or user sending funds.

string

required

Source ledger account ID.

string

required

Transfer status. processing means the on-chain leg is still executing — poll the transfer until it resolves to succeeded or failed.Available options: processing, succeeded, failed

Transfer

{
	"id": "tr_xxxxxxxxxxxxx",
	"amount": 50,
	"created_at": "2026-06-01T12:00:00Z",
	"created_by_user": {
		"id": "user_xxxxxxxxxxxxx",
		"name": "Jordan Lee",
		"username": "jordan"
	},
	"currency": "usd",
	"destination": {
		"id": "user_xxxxxxxxxxxxx",
		"name": "Alex Rivera",
		"typename": "User",
		"username": "alex"
	},
	"destination_ledger_account_id": "la_destxxxxxxxx",
	"fee_amount": null,
	"metadata": {
		"external_transfer_id": "transfer_123"
	},
	"notes": "Creator bonus",
	"object": "transfer",
	"origin": {
		"id": "biz_xxxxxxxxxxxxxx",
		"route": "pickaxe",
		"title": "Pickaxe",
		"typename": "Company"
	},
	"origin_ledger_account_id": "la_originxxxxxx",
	"status": "succeeded"
}

Introduction

Reference

Core Resources

Notifications

Money

Commerce

Partners

Workforce

Tracking

Ads

Media

Identity

Developer

Endpoints

Attributes

​Endpoints

​Attributes

Endpoints

Attributes