---
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` (bank had nothing on file), `warning` (bank could not confirm ownership), `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_default` boolean, required — Whether this is the default payout method for the account.
    - `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 the last payout failed.
    - `supported_payout_method` object, nullable, required — The supported payout method this saved method was created from.
      - `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_standard_delivery` boolean, required
  - `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.
      - `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.
    - `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/versions/db0883548bc5/schema)
