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

# Get customer payment methods

> Returns confirmed, non-deleted payment methods for a customer.



## OpenAPI

````yaml /openapi.yaml get /v1/customers/{customerId}/payment_methods
openapi: 3.0.3
info:
  title: Quentli REST API
  version: 1.0.0
  description: OpenAPI spec for Quentli REST endpoints.
servers:
  - url: https://api.quentli.com
    description: Production API
  - url: https://api.staging.quentli.com
    description: Staging API for production-like validation
  - url: https://api.demo.quentli.com
    description: Demo API hostname served by staging
security:
  - organizationApiKey: []
tags:
  - name: Auth
  - name: Billing
  - name: Catalog
  - name: Customers
  - name: Invoices
  - name: Payment Methods
  - name: Payment Sessions
  - name: Payments
  - name: Subscriptions
  - name: Tax Invoices
  - name: Webhooks
paths:
  /v1/customers/{customerId}/payment_methods:
    get:
      tags:
        - Customers
      summary: Get customer payment methods
      description: Returns confirmed, non-deleted payment methods for a customer.
      operationId: customers_get_payment_methods
      parameters:
        - schema:
            type: string
            description: Identifier of the customer.
          required: true
          description: Identifier of the customer.
          name: customerId
          in: path
      responses:
        '200':
          description: Confirmed payment methods
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCustomerPaymentMethodsResponse'
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserError'
        '403':
          description: Permission denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserError'
        '404':
          description: Customer not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserError'
components:
  schemas:
    GetCustomerPaymentMethodsResponse:
      type: array
      items:
        $ref: '#/components/schemas/PaymentMethod'
      description: Confirmed and non-deleted payment methods for the customer.
    UserError:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
          required:
            - message
      required:
        - error
      additionalProperties: false
      description: Standard user-facing error response envelope.
    PaymentMethod:
      type: object
      properties:
        id:
          type: string
          description: Payment method identifier.
        createdAt:
          anyOf:
            - type: string
              format: date-time
              description: ISO date-time string
            - type: string
              format: date-time
              description: Date object
          description: Date and time when payment method was created.
        updatedAt:
          anyOf:
            - type: string
              format: date-time
              description: ISO date-time string
            - type: string
              format: date-time
              description: Date object
          description: Date and time when payment method was last updated.
        customerId:
          type: string
          description: Identifier of the customer that owns this payment method.
        type:
          type: string
          enum:
            - CARD
            - MEXICAN_BANK_ACCOUNT
          description: Type of payment method (card or Mexican bank account).
        confirmed:
          type: boolean
          description: Whether this payment method can be used to collect payments.
        default:
          type: boolean
          description: Whether this is the default method used for automatic collections.
        expired:
          type: boolean
          description: Whether this payment method is no longer valid.
        cardDetail:
          type: object
          nullable: true
          properties:
            id:
              type: string
              description: Card detail identifier.
            createdAt:
              anyOf:
                - type: string
                  format: date-time
                  description: ISO date-time string
                - type: string
                  format: date-time
                  description: Date object
              description: Date and time when card details were created.
            updatedAt:
              anyOf:
                - type: string
                  format: date-time
                  description: ISO date-time string
                - type: string
                  format: date-time
                  description: Date object
              description: Date and time when card details were last updated.
            expiryMonth:
              type: number
              description: Card expiration month (1-12).
            expiryYear:
              type: number
              description: Card expiration year (YYYY).
            cardholder:
              type: string
              nullable: true
              description: Name printed on the card, if available.
            bin:
              type: string
              description: Bank Identification Number (first 6 digits).
            last4:
              type: string
              description: Last four digits of the card.
            brand:
              type: string
              nullable: true
              description: Card brand (e.g. VISA, MASTERCARD).
            issuer:
              type: string
              nullable: true
              description: Issuing bank or institution.
            isCorporate:
              type: boolean
              nullable: true
              description: Whether the card is a corporate card.
            country:
              type: string
              nullable: true
              description: ISO country code for the card issuer.
            funding:
              type: string
              nullable: true
              description: Funding category (for example, CREDIT or DEBIT).
          required:
            - id
            - createdAt
            - updatedAt
            - expiryMonth
            - expiryYear
            - bin
            - last4
          description: Card details when `type` is `CARD`.
        bankAccount:
          type: object
          nullable: true
          properties:
            id:
              type: string
              description: Bank account identifier.
            createdAt:
              anyOf:
                - type: string
                  format: date-time
                  description: ISO date-time string
                - type: string
                  format: date-time
                  description: Date object
              description: Date and time when bank account was created.
            updatedAt:
              anyOf:
                - type: string
                  format: date-time
                  description: ISO date-time string
                - type: string
                  format: date-time
                  description: Date object
              description: Date and time when bank account was last updated.
            bankCode:
              type: string
              description: Bank institution code.
            bankName:
              type: string
              description: Bank institution name.
            customerId:
              type: string
              nullable: true
              description: Owner customer identifier.
            deletedAt:
              anyOf:
                - type: string
                  format: date-time
                  description: ISO date-time string
                - type: string
                  format: date-time
                  description: Date object
                - nullable: true
              description: Date and time when this bank account was deleted.
            country:
              type: string
              description: ISO country code where the account is registered.
            verified:
              type: boolean
              description: Whether bank account ownership was verified.
            clabeLast:
              type: string
              description: Last visible digits of the CLABE/account number.
            clabeFirst:
              type: string
              description: First visible digits of the CLABE/account number.
          required:
            - id
            - createdAt
            - updatedAt
            - bankCode
            - bankName
            - country
            - verified
            - clabeLast
            - clabeFirst
          description: Bank account details when `type` is `MEXICAN_BANK_ACCOUNT`.
      required:
        - id
        - createdAt
        - updatedAt
        - customerId
        - type
        - confirmed
        - default
        - expired
      description: Saved payment method associated with a customer.
  securitySchemes:
    organizationApiKey:
      type: http
      scheme: bearer
      description: 'Organization API key using `Authorization: Bearer sk_...`.'

````