> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/api-reference/beta/transfers/list-transfers)       | <Badge color="blue" size="sm" stroke>GET</Badge> `/transfers`      |
| [Create Transfer](/api-reference/beta/transfers/create-transfer)     | <Badge color="green" size="sm" stroke>POST</Badge> `/transfers`    |
| [Retrieve Transfer](/api-reference/beta/transfers/retrieve-transfer) | <Badge color="blue" size="sm" stroke>GET</Badge> `/transfers/{id}` |

## Attributes

<Columns cols={2}>
  <Column>
    <ResponseField name="amount" type="number" required>
      Transfer amount.
    </ResponseField>

    <ResponseField name="created_at" type="string" required>
      When the transfer was created.
    </ResponseField>

    <ResponseField name="currency" type="string" required>
      Transfer currency.
    </ResponseField>

    <ResponseField name="destination" type="object" required>
      Account or user receiving funds.
    </ResponseField>

    <ResponseField name="destination_ledger_account_id" type="string" required>
      Destination ledger account ID.
    </ResponseField>

    <ResponseField name="fee_amount" type="number | null">
      Fee charged for the transfer.
    </ResponseField>

    <ResponseField name="id" type="string" required>
      Transfer ID.
    </ResponseField>

    <ResponseField name="metadata" type="object | null">
      Custom metadata attached to the transfer.
    </ResponseField>

    <ResponseField name="notes" type="string | null">
      Transfer note.
    </ResponseField>

    <ResponseField name="origin" type="object" required>
      Account or user sending funds.
    </ResponseField>

    <ResponseField name="origin_ledger_account_id" type="string" required>
      Source ledger account ID.
    </ResponseField>
  </Column>

  <Column>
    <div className="api-resource-sticky-example">
      ```json Transfer theme={null}
      {
      	"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"
      }
      ```
    </div>
  </Column>
</Columns>
