> ## 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.

# Payouts

Payouts represent money sent from an account or user balance to an external destination, such as a bank account, wallet, or other saved payout method.

Use the Payouts API to create payouts from stablecoin accounts, list payout history for accounts or users, monitor payout statuses, and show expected arrival details for funds leaving Whop.

## Endpoints

| Endpoint                                                               | Request                                                             |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------- |
| [Create Payout](/api-reference/beta/payouts/create-payout)             | <Badge color="green" size="sm" stroke>POST</Badge> `/payouts`       |
| [List Payouts](/api-reference/beta/payouts/list-payouts)               | <Badge color="blue" size="sm" stroke>GET</Badge> `/payouts`         |
| [List Payout Methods](/api-reference/beta/payouts/list-payout-methods) | <Badge color="blue" size="sm" stroke>GET</Badge> `/payouts/methods` |

## Attributes

<Columns cols={2}>
  <Column>
    <ResponseField name="id" type="string" required>
      Payout ID.
    </ResponseField>

    <ResponseField name="amount" type="number" required>
      The payout amount in whole currency units.
    </ResponseField>

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

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

    <ResponseField name="estimated_arrival" type="string | null" required>
      Estimated time the funds become available in the destination account.
    </ResponseField>

    <ResponseField name="fee_amount" type="number" required>
      The fee charged for the payout, in the payout currency.
    </ResponseField>

    <ResponseField name="object" type="string" required />

    <ResponseField name="payer_name" type="string | null" required>
      Name of the entity processing the payout.
    </ResponseField>

    <ResponseField name="payout_request_id" type="string | null" required>
      The ID returned by POST /payouts when this payout was requested. Match it to
      the settled payout in GET /payouts. Null for payouts not created by POST
      /payouts.
    </ResponseField>

    <ResponseField name="payout_token" type="object | null" required>
      The saved payout method used. Requires payout:destination:read; null without it.

      <Accordion title="Properties" defaultOpen={true}>
        <ResponseField name="nickname" type="string | null" required>
          Saved payout method nickname.
        </ResponseField>

        <ResponseField name="payout_destination" type="object | null" required>
          Payout destination display details.

          <Accordion title="Properties" defaultOpen={true}>
            <ResponseField name="icon_url" type="string | null" required>
              Payout destination icon URL.
            </ResponseField>

            <ResponseField name="payer_name" type="string | null" required>
              Payout destination display name.
            </ResponseField>
          </Accordion>
        </ResponseField>
      </Accordion>
    </ResponseField>

    <ResponseField name="speed" type="string" required>
      Payout delivery speed.

      Available options: `standard`, `instant`
    </ResponseField>

    <ResponseField name="status" type="string" required>
      Current payout status.

      Available options: `requested`, `awaiting_payment`, `in_transit`, `completed`, `failed`, `canceled`, `denied`
    </ResponseField>
  </Column>

  <Column>
    <div className="api-resource-sticky-example">
      ```json Payout theme={null}
      {
      	"id": "po_xxxxxxxxxxxxx",
      	"amount": 125.5,
      	"created_at": "2026-06-01T12:00:00Z",
      	"currency": "usd",
      	"estimated_arrival": "2026-06-03T12:00:00Z",
      	"fee_amount": 1.25,
      	"object": "payout",
      	"payer_name": "Whop Payments",
      	"payout_request_id": "cofr_xxxxxxxxxxxxx",
      	"payout_token": {
      		"nickname": "Operating account",
      		"payout_destination": {
      			"icon_url": "https://cdn.whop.com/bank.png",
      			"payer_name": "Whop Payments"
      		}
      	},
      	"speed": "standard",
      	"status": "completed"
      }
      ```
    </div>
  </Column>
</Columns>
