---
title: "List Saved Payout Methods"
method: GET
path: "/payouts/methods"
tags: ["Payouts"]
---

# List Saved Payout Methods

`GET /payouts/methods`

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

## Query parameters

- `account_id` string
- `user_id` string
- `status` 'created' | 'active' | 'broken'
- `amount` number
- `currency` string
- `include_limits` boolean
- `first` integer
- `after` string
- `last` integer
- `before` string

## Response `200`

internal stablecoin destinations omitted

- object
  - `data` object[], required
    - `account_reference` string, nullable, required — Masked identifier for the destination, such as the last four digits of a bank account.
    - `bank_verification_state` 'checking' | 'verified' | 'no_data' | 'warning' | 'broken' | 'null', nullable, required — Lifecycle trust state: `checking` (verification still running), `verified` (bank confirmed ownership or a payout already completed to it), `no_data` (verification unavailable or bank returned no ownership data), `warning` (bank could not confirm the destination's owner), `broken` (payouts failed with a permanent account error), `null` (never checked).
    - `created_at` string, date-time, required — When the payout method was added.
    - `destination_currency` string, required — Currency payouts are delivered in for this method.
    - `estimated_arrival` object, nullable, required — Estimated arrival times before an amount-specific quote is requested. Null when the method is not currently eligible.
      - `instant` string, date-time, nullable, required — Estimated instant-delivery arrival, or null when unavailable.
      - `standard` string, date-time, nullable, required — Estimated standard-delivery arrival, or null when unavailable.
    - `fee_structure` object, nullable, required — Configured fee terms for this payout method. Null when the method is not currently eligible. An amount-specific quote remains authoritative.
      - `currency` string, required — Currency code of fixed_amount.
      - `fixed_amount` number, float, required — Fixed fee charged, denominated in `currency`.
      - `percentage` number, float, required — Percentage of the withdrawal amount charged as a fee.
    - `id` string, required — Payout method ID.
    - `institution_name` string, nullable, required — Name of the bank or institution receiving payouts.
    - `is_clone` boolean, required — Whether this method is a copy of one saved on another of the payer's accounts.
    - `is_default` boolean, required — Whether this is the default payout method for the account.
    - `last_paid_out_at` string, date-time, nullable, required — When the most recent completed payout was delivered to this method, as an ISO 8601 timestamp. `null` when nothing has been paid out to it yet.
    - `linked_via_plaid` boolean, required — Whether the payer added this method by signing in to their bank rather than typing account details.
    - `needs_plaid_reconnect` boolean, required — Whether the bank sign-in behind this method has expired and must be redone before it counts as linked.
    - `nickname` string, nullable, required — User-defined label for the payout method.
    - `object` 'payout_method', required
    - `payer_name` string, nullable, required — Display name of the payout rail, such as `ACH Bank Deposit`.
    - `quote` object, nullable, required — Fee and delivery estimate for withdrawing the requested amount through this method. Null unless an amount was provided, or when the estimate is unavailable.
      - `amount` number, float, required — The withdrawal amount the quote is for.
      - `currency` string, required — Currency of the quoted amount.
      - `exchange_rate` number, float, required — Exchange rate from the withdrawal currency to the destination currency.
      - `instant` object, nullable, required — Instant-delivery estimate. Null if the method does not support instant delivery, instant delivery is unavailable for the account, or the amount does not cover the fee.
        - `fee` number, float, required — Total fee charged, in the withdrawal currency.
        - `total_received` number, float, required — Amount delivered after fees, in the withdrawal currency.
      - `max_limit` number, float, nullable, required — Maximum withdrawal amount for this method, in the withdrawal currency.
      - `min_limit` number, float, required — Minimum withdrawal amount for this method, in the withdrawal currency.
      - `standard` object, nullable, required — Standard-delivery estimate. Null if the method does not support standard delivery, or the amount does not cover the fee.
        - `fee` number, float, required — Total fee charged, in the withdrawal currency.
        - `total_received` number, float, required — Amount delivered after fees, in the withdrawal currency.
    - `status` 'created' | 'active' | 'broken', required — Lifecycle status: `created` means saved but unused, `active` means a payout succeeded through it, `broken` means a payout failure disabled it; a later successful payout returns it to `active`.
    - `status_reason` string, nullable, required — Machine-readable code for why the method is `broken` — the newest disabling failure recorded through it, whether a payout error or a pre-payout rejection. `null` unless the method is broken, or when it was disabled without a recorded failure.
    - `supported_payout_method` object, nullable, required — The supported payout method this saved method was created from.
      - `country_code` string, nullable, required — ISO 3166-1 alpha-3 country the destination pays out to.
      - `delivery_type` 'cash_pickup' | 'bank_deposit' | 'home_delivery' | 'mobile_wallet' | 'masspay_card' | 'paper_check' | 'bill' | 'cryptocurrency' | 'unknown', required — How funds are delivered.
      - `icon_url` string, nullable, required — Supported payout method icon URL.
      - `name` string, nullable, required — Supported payout method display name.
      - `supports_instant_delivery` boolean, required
      - `supports_plaid` boolean, required — Whether the payer can link this method by signing in to their bank instead of typing account details.
      - `supports_standard_delivery` boolean, required
    - `unavailable_reason` 'destination_retired' | 'null', nullable, required — Why this method is unavailable: `destination_retired` means the payout provider stopped offering the destination. Whop may automatically remap an eligible method that was not linked through Plaid to a compatible replacement; otherwise, the account owner must re-add it. `null` means no unavailability reason is known.
  - `limits` object — The live per-speed payout caps for the account in the requested currency — the numbers a payout request is validated against at submit time, so clients can cap an amount input at a value the request will accept. Only present when include_limits is true.
    - `currency` string, required — The currency the caps are denominated in.
    - `instant` object, required — Caps for instant-speed payouts, which additionally draw on pending funds.
      - `daily_amount_remaining` number, float, nullable, required — How much of the account's daily instant allowance is left, in the requested currency. Null when the account is exempt from the daily cap, which is not the same as 0.
      - `error_code` 'amount_too_high' | 'account_daily_limit_reached' | 'restricted_account' | 'feature_disabled' | 'null', nullable, required — Why instant payouts are unavailable for this account, or null when they are available.
      - `error_message` string, nullable, required — Human-readable form of error_code, or null when instant payouts are available.
      - `max_amount` number, float, required — The maximum amount an instant payout can move right now, in whole currency units. Already bounded by the remaining daily instant allowance; 0 while an eligibility error blocks instant payouts.
      - `resets_at` string, date-time, nullable, required — When the daily instant allowance resets, or null when the account is exempt from the daily cap.
    - `object` 'payout_limit', required
    - `standard` object, required — Caps for standard-speed payouts, which draw on settled funds only.
      - `max_amount` number, float, required — The maximum amount a standard payout can move right now, in whole currency units.
  - `page_info` object, required
    - `end_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Resource not found

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/f1cf47ad0ec2/schema)