Sign in
Payouts

List Saved Payout Methods

Lists the bank accounts, wallets, and crypto addresses an account or user can pay out to, newest first.

get/payouts/methods

Query parameters

account_idstring

The owning account ID (a biz_ identifier). Provide this or user_id.

user_idstring

The owning user ID (a user_ identifier). Provide this or account_id.

status'created' | 'active' | 'broken'

Optional status filter. created means saved but unused, active means a payout through it succeeded, broken means the last payout failed and the method needs fixing.

amountnumber

Optional payout amount in whole currency units, for example 250.00. When provided, each method includes a quote with the estimated fee, amount received, and delivery date for that amount.

currencystring

Currency code of the amount, for example usd. Only meaningful with amount or include_limits.

include_limitsboolean

When true, the response also carries limits — the live per-speed payout caps the account's payout requests are validated against, in the requested currency. Requires the payout:withdrawal:read scope.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

Response

payout methods listed

Example response

{
  "data": [
    {
      "account_reference": "••••6789",
      "bank_verification_state": "verified",
      "created_at": "2026-06-15T09:00:00.000Z",
      "destination_currency": "usd",
      "estimated_arrival": {
        "instant": "2026-07-30T12:30:00.000Z",
        "standard": "2026-08-03T00:00:00.000Z"
      },
      "fee_structure": {
        "currency": "usd",
        "fixed_amount": 0.25
      },
      "id": "pyot_xxxxxxxxxxxxx",
      "institution_name": "Frost Bank",
      "is_default": true,
      "last_paid_out_at": "2026-08-02T15:30:00.000Z",
      "nickname": "Business checking",
      "object": "payout_method",
      "payer_name": "ACH Bank Deposit",
      "quote": {
        "amount": 500,
        "currency": "usd",
        "exchange_rate": 1,
        "instant": {
          "fee": 5.25,
          "total_received": 494.75
        },
        "instant_unavailable_reason": "minimum_crypto_sales_not_met",
        "max_limit": 25000,
        "min_limit": 1,
        "standard": {
          "fee": 0.25,
          "total_received": 499.75
        }
      },
      "status": "active",
      "supported_payout_method": {
        "country_code": "USA",
        "delivery_type": "bank_deposit",
        "icon_url": "https://cdn.whop.com/payouts/ach.png",
        "name": "ACH Bank Deposit",
        "supports_plaid": true,
        "supports_standard_delivery": true
      }
    }
  ],
  "limits": {
    "currency": "usd",
    "instant": {
      "daily_amount_remaining": 9999,
      "error_code": "restricted_account",
      "error_message": "Instant payouts are not available for your account at this time.",
      "resets_at": "2026-01-01T12:00:00.000Z"
    },
    "object": "payout_limit",
    "standard": {
      "error_code": "no_available_balance",
      "error_message": "You don't have an available balance to withdraw.",
      "max_amount": 500
    }
  },
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes