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

# List Payment Methods

> List all payment methods for the authenticated user.

**API scope required**: `payment-methods.read`

<Warning>
  This endpoint requires a JWT from an **external auth provider** (Auth0, Firebase, Stytch, etc.) or a **custom JWT** backed by a JWKS endpoint. Crossmint Auth is not supported.
</Warning>


## OpenAPI

````yaml get /unstable/payment-methods
openapi: 3.0.0
info:
  contact:
    email: support@crossmint.com
    name: Crossmint Support
    url: https://www.crossmint.com
  description: Crossmint Agents API
  title: Crossmint Agents API
  version: 1.0.0
servers:
  - description: Staging environment (testnets)
    url: https://staging.crossmint.com/api
  - description: Production environment (mainnets)
    url: https://www.crossmint.com/api
security: []
tags: []
paths:
  /unstable/payment-methods:
    get:
      tags:
        - Payment Methods
      summary: List Payment Methods
      description: |-
        List all payment methods for the authenticated user.

        **API scope required**: `payment-methods.read`
      operationId: PaymentMethodsController-getPaymentMethods-2
      parameters:
        - description: API key required for authentication
          in: header
          name: X-API-KEY
          required: true
          schema:
            type: string
        - in: query
          name: cursor
          required: false
          schema:
            type: string
        - in: query
          name: limit
          required: false
          schema:
            type: string
        - in: query
          name: sort
          required: false
          schema:
            enum:
              - asc
              - desc
            type: string
        - in: query
          name: type
          required: false
          schema:
            enum:
              - bank-account-br
              - bank-account-co
              - bank-account-mx-clabe
              - bank-account-sepa-iban
              - bank-account-us
              - bre-b
              - card
              - pix
            type: string
        - description: >-
            Filter to payment methods that have (true) or have not (false)
            funded a settled offramp payout. When set to false, cards are
            included in results. Omit to return all payment methods regardless
            of payout history.
          in: query
          name: hasPayout
          required: false
          schema:
            enum:
              - 'false'
              - 'true'
            type: string
        - description: >-
            Identifies the target user when authenticating with a server API
            key. Format: `<type>:<value>` (e.g., `email:alice@example.com`,
            `userId:abc123`, `phoneNumber:+12125551234`, `twitter:alice`).
            Required for API-key authentication; ignored when authenticating
            with a JWT (the JWT subject is used).
          in: query
          name: userLocator
          required: false
          schema: {}
      responses:
        '200':
          description: Returns the list of payment methods

````