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

Changed in 10 of the 74 revisions of this API.4724

  • 1660b8d622041See the full diff
    • ●

      added the new guardian_id_clear enum value to the // response property for the response status

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 621705ee8f4a22See the full diff
    • ●

      added the new card enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new check enum value to the /// response property for the response status

      response-property-enum-value-added

    • ○

      removed the masspay_card enum value from the /// response property for the response status

      response-property-enum-value-removed

    • ○

      removed the paper_check enum value from the /// response property for the response status

      response-property-enum-value-removed

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • f1cf47ad0ec22See the full diff
    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 6fb1c04bf2555See the full diff
    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

  • a8a43db4255f1See the full diff
    • ○

      added the required property // to the response with the status

      response-required-property-added

  • f1020c3ecda44See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 6c970f803b4611See the full diff
    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • ca841fbd67861See the full diff
    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 099fdc3be422343See the full diff
    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property //// from the response with the status

      response-required-property-removed

    • ▲

      removed the required property //// from the response with the status

      response-required-property-removed

    • ●

      deleted the query request parameter destination_currency

      request-parameter-removed

    • ●

      deleted the query request parameter destination_id

      request-parameter-removed

    • ●

      deleted the query request parameter include_available

      request-parameter-removed

    • ●

      removed the optional property from the response with the status

      response-optional-property-removed

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 60bbb4a6ffbc5See the full diff
    • ○

      added the new optional query request parameter destination_currency

      new-optional-request-parameter

    • ○

      added the new optional query request parameter destination_id

      new-optional-request-parameter

    • ○

      added the new optional query request parameter include_limits

      new-optional-request-parameter

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.