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

# List Payout Methods

`GET /payouts/methods`

Lists the saved payout methods (bank accounts, digital wallets, crypto addresses) that an account or user can withdraw to, most recently added first. Pass exactly one of account_id (a biz_ identifier) or user_id (a user_ identifier). Pass an amount to additionally get a fee and delivery quote per method for withdrawing that amount.

## Query parameters

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

## Response `200`

internal stablecoin destinations omitted

- object
  - `available_destinations` object[] — Payout rails the account could add as a new payout method. Only present when include_available is true; empty when the account has no payout setup yet.
    - `delivery_type` string, required — How funds are delivered, for example `bank_deposit`.
    - `icon_url` string, nullable, required — Payout destination icon URL.
    - `id` string, required — Payout destination ID.
    - `name` string, nullable, required — Payout destination display name.
    - `object` 'payout_destination', required
    - `quotes` object[], nullable, required — Fee and delivery estimates for withdrawing the requested amount through this destination, one per destination currency. Null unless an amount was provided.
      - `amount` number, float, required — The withdrawal amount the quote is for.
      - `currency` string, required — Currency of the quoted amount.
      - `destination_currency` string, required — Currency the funds are delivered in.
      - `exchange_rate` number, float, required — Exchange rate from the withdrawal currency to the destination currency.
      - `instant` object, nullable, required — Instant-delivery estimate. Null if unsupported, unavailable for the account, or the amount does not cover the fee.
        - `estimated_arrival` string, date-time, required
        - `fee` number, float, required
        - `total_received` number, float, required
      - `max_limit` number, float, nullable, required — Maximum withdrawal amount, in the withdrawal currency.
      - `min_limit` number, float, required — Minimum withdrawal amount, in the withdrawal currency.
      - `standard` object, nullable, required — Standard-delivery estimate. Null if unsupported or the amount does not cover the fee.
        - `estimated_arrival` string, date-time, required
        - `fee` number, float, required
        - `total_received` number, float, required
    - `required_fields` object[], nullable, required — The fields to collect to add this destination as a payout method. Present only when the request narrows to one destination with destination_id; null otherwise.
      - `id` string, required — Field ID, echoed back as the field key when creating the payout method.
      - `input_type` string, required — How to collect the value: `text`, `options`, or `date`.
      - `label` string, required — Human-readable field name.
      - `object` 'required_field', required
      - `options` string[], nullable, required — Allowed values, for options fields.
      - `placeholder` string, nullable, required — Example value.
      - `required` boolean, required — Whether the field must be provided.
      - `sensitive` boolean, required — Whether the value is vaulted in transit and never stored raw, such as a bank account number.
      - `type` string, required — Semantic field type, for example `bank_account_number` or `swift`.
      - `validation` string, nullable, required — Regex the value must match. Null for options fields.
    - `supports_instant_delivery` boolean, required
    - `supports_standard_delivery` boolean, required
  - `data` object[], required
    - `account_reference` string, nullable, required — Masked identifier for the destination, such as the last four digits of a bank account.
    - `created_at` string, date-time, required — When the payout method was added.
    - `destination_currency` string, required — Currency payouts are delivered in for this method.
    - `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`.
    - `payout_destination` object, nullable, required — The payout rail this method delivers through.
      - `delivery_type` string, required — How funds are delivered, for example `bank_deposit`.
      - `icon_url` string, nullable, required — Payout destination icon URL.
      - `name` string, nullable, required — Payout destination display name.
      - `supports_instant_delivery` boolean, required
      - `supports_standard_delivery` boolean, required
    - `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.
        - `estimated_arrival` string, date-time, required — Estimated time the funds become available.
        - `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.
        - `estimated_arrival` string, date-time, required — Estimated time the funds become available.
        - `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.
  - `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

## Changes

- **2026-07-26** `60bbb4a6ffbc` — 5 info
  - added the new optional `query` request parameter `destination_currency`
  - added the new optional `query` request parameter `destination_id`
  - added the new optional `query` request parameter `include_limits`
  - added the optional property `limits` to the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/payouts/methods/get.md)

---

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