> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Payout 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.



## OpenAPI

````yaml /openapi/api-v1-native.yml get /payouts/methods
openapi: 3.1.0
info:
  title: Whop API
  description: >-
    Hand-written V1 endpoints. Merged into the GraphqlRestProxy-generated schema
    at build time.
  version: v1
servers:
  - url: https://{defaultHost}
    variables:
      defaultHost:
        default: api.whop.com/api/v1
security: []
paths:
  /payouts/methods:
    parameters:
      - $ref: '#/components/parameters/ApiVersionDate'
    get:
      tags:
        - Payouts
      summary: List Payout Methods
      description: >-
        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.
      operationId: listPayoutMethods
      parameters:
        - name: account_id
          in: query
          required: false
          schema:
            type: string
          description: The owning account ID (a biz_ identifier). Provide this or user_id.
        - name: user_id
          in: query
          required: false
          schema:
            type: string
          description: The owning user ID (a user_ identifier). Provide this or account_id.
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - created
              - active
              - broken
          description: >-
            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.
        - name: amount
          in: query
          required: false
          schema:
            type: number
          description: >-
            Optional withdrawal 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.
        - name: currency
          in: query
          required: false
          schema:
            type: string
            default: usd
          description: >-
            Currency code of the amount, for example `usd`. Only meaningful with
            amount.
        - name: first
          in: query
          required: false
          schema:
            type: integer
            default: 20
            maximum: 100
          description: >-
            Number of payout methods to return from the start of the window.
            Capped at 25 when an amount is provided.
        - name: after
          in: query
          required: false
          schema:
            type: string
          description: Cursor to fetch the page after (from page_info.end_cursor).
        - name: last
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
          description: Number of payout methods to return from the end of the window.
        - name: before
          in: query
          required: false
          schema:
            type: string
          description: Cursor to fetch the page before (from page_info.start_cursor).
      responses:
        '200':
          description: internal stablecoin destinations omitted
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        object:
                          type: string
                          enum:
                            - payout_method
                        id:
                          type: string
                          description: Payout method ID.
                        status:
                          type: string
                          enum:
                            - created
                            - active
                            - broken
                          description: >-
                            Lifecycle status: `created` means saved but unused,
                            `active` means a payout succeeded through it,
                            `broken` means the last payout failed.
                        is_default:
                          type: boolean
                          description: >-
                            Whether this is the default payout method for the
                            account.
                        nickname:
                          type:
                            - string
                            - 'null'
                          description: User-defined label for the payout method.
                        account_reference:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Masked identifier for the destination, such as the
                            last four digits of a bank account.
                        institution_name:
                          type:
                            - string
                            - 'null'
                          description: Name of the bank or institution receiving payouts.
                        payer_name:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Display name of the payout rail, such as `ACH Bank
                            Deposit`.
                        destination_currency:
                          type: string
                          description: Currency payouts are delivered in for this method.
                        created_at:
                          type: string
                          format: date-time
                          description: When the payout method was added.
                        payout_destination:
                          type:
                            - object
                            - 'null'
                          description: The payout rail this method delivers through.
                          properties:
                            name:
                              type:
                                - string
                                - 'null'
                              description: Payout destination display name.
                            icon_url:
                              type:
                                - string
                                - 'null'
                              description: Payout destination icon URL.
                            delivery_type:
                              type: string
                              description: >-
                                How funds are delivered, for example
                                `bank_deposit`.
                            supports_standard_delivery:
                              type: boolean
                            supports_instant_delivery:
                              type: boolean
                          required:
                            - name
                            - icon_url
                            - delivery_type
                            - supports_standard_delivery
                            - supports_instant_delivery
                        quote:
                          type:
                            - object
                            - 'null'
                          description: >-
                            Fee and delivery estimate for withdrawing the
                            requested amount through this method. Null unless an
                            amount was provided, or when the estimate is
                            unavailable.
                          properties:
                            amount:
                              type: number
                              format: float
                              description: The withdrawal amount the quote is for.
                            currency:
                              type: string
                              description: Currency of the quoted amount.
                            exchange_rate:
                              type: number
                              format: float
                              description: >-
                                Exchange rate from the withdrawal currency to
                                the destination currency.
                            min_limit:
                              type: number
                              format: float
                              description: >-
                                Minimum withdrawal amount for this method, in
                                the withdrawal currency.
                            max_limit:
                              type:
                                - number
                                - 'null'
                              format: float
                              description: >-
                                Maximum withdrawal amount for this method, in
                                the withdrawal currency.
                            standard:
                              type:
                                - object
                                - 'null'
                              description: >-
                                Standard-delivery estimate. Null if the method
                                does not support standard delivery, or the
                                amount does not cover the fee.
                              properties:
                                fee:
                                  type: number
                                  format: float
                                  description: >-
                                    Total fee charged, in the withdrawal
                                    currency.
                                total_received:
                                  type: number
                                  format: float
                                  description: >-
                                    Amount delivered after fees, in the
                                    withdrawal currency.
                                estimated_arrival:
                                  type: string
                                  format: date-time
                                  description: Estimated time the funds become available.
                              required:
                                - fee
                                - total_received
                                - estimated_arrival
                            instant:
                              type:
                                - object
                                - 'null'
                              description: >-
                                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.
                              properties:
                                fee:
                                  type: number
                                  format: float
                                  description: >-
                                    Total fee charged, in the withdrawal
                                    currency.
                                total_received:
                                  type: number
                                  format: float
                                  description: >-
                                    Amount delivered after fees, in the
                                    withdrawal currency.
                                estimated_arrival:
                                  type: string
                                  format: date-time
                                  description: Estimated time the funds become available.
                              required:
                                - fee
                                - total_received
                                - estimated_arrival
                          required:
                            - amount
                            - currency
                            - exchange_rate
                            - min_limit
                            - max_limit
                            - standard
                            - instant
                      required:
                        - object
                        - id
                        - status
                        - is_default
                        - nickname
                        - account_reference
                        - institution_name
                        - payer_name
                        - destination_currency
                        - created_at
                        - payout_destination
                        - quote
                  page_info:
                    type: object
                    properties:
                      has_next_page:
                        type: boolean
                      end_cursor:
                        type:
                          - string
                          - 'null'
                      has_previous_page:
                        type: boolean
                      start_cursor:
                        type:
                          - string
                          - 'null'
                    required:
                      - has_next_page
                      - end_cursor
                      - has_previous_page
                      - start_cursor
                required:
                  - data
                  - page_info
        '400':
          $ref: '#/components/responses/InvalidParameters'
          description: neither account_id nor user_id provided
        '401':
          $ref: '#/components/responses/Unauthorized'
          description: missing or invalid authentication
        '403':
          $ref: '#/components/responses/Forbidden'
          description: credential lacks the destination-read scope
        '404':
          $ref: '#/components/responses/NotFound'
          description: no ledger for that owner is visible to the credential
      security:
        - bearerAuth:
            - payout:destination:read
components:
  parameters:
    ApiVersionDate:
      name: Api-Version-Date
      in: header
      required: false
      schema:
        type: string
        format: date
        example: '2026-07-01'
      description: Pins the request to a dated API version.
  responses:
    InvalidParameters:
      description: Invalid Parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/V1ErrorResponse'
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/V1ErrorResponse'
    Forbidden:
      description: Forbidden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/V1ErrorResponse'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/V1ErrorResponse'
  schemas:
    V1ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              description: Machine-readable error code.
            message:
              type: string
              description: Human-readable error message.
          required:
            - type
            - message
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: auth-scheme
      description: >-
        An account API key, account scoped JWT, app API key, or user OAuth
        token.

````