---
title: "List Payment Methods"
method: GET
path: "/payment_methods"
tags: ["Payment Methods"]
---

# List Payment Methods

`GET /payment_methods`

## Request

- Base URL: `https://api.justifi.ai/v1`
- URL: `https://api.justifi.ai/v1/payment_methods`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/justifi/apis/justifi-api-documentation/docs/payment_methods/get.ts> (a function with typed inputs; its response is checked against the schema)

List the payment methods for your account. This endpoint supports [pagination](https://docs.justifi.tech/api-spec#section/Pagination).

## Query parameters

- `customer_id` string
- `payment_method_group_id` string
- `payment_method_import_id` string
- `created_before` string, date-time
- `created_after` string, date-time

## Headers

- `Authorization` string, required
- `Sub-Account` string

## Response `200`

Successfully list payment methods

- object
  - `id` number: the object id
  - `type` string: the object type, or array of objects
  - `data` union[]: the list of objects
    - union
      - CardPaymentMethodWithBinDetails
        - `id` string: unique id of the payment method
        - `status` string: signals whether the payment method is valid or invalid
        - `invalid_reason` string, nullable: informs reason that the payment method has been marked invalid, if status is invalid
        - `payment_method_import_id` string, nullable: id of the payment method import that created this payment method, if it was imported
        - `created_at` string, date-time
        - `updated_at` string, date-time
        - `card` CardWithBinDetails
          - `id` string, uuid: unique card id
          - `acct_last_four` string: last 4 digits of the card number
          - `brand` string: card brand or bank name
          - `digital_wallet` 'apple_pay' | 'google_pay' | 'null', nullable: which digital wallet provider the card is tied to
          - `name` string, nullable: card or account holder name
          - `token` string: same value as unique card id; can be saved and used to process multiple payments with the same card
          - `month` string: expiration date month
          - `year` string: expiration date year
          - `metadata` object, nullable: any useful information you'd like to store alongside this card
          - `address_line1_check` 'fail' | 'pass' | 'unavailable' | 'unchecked': Result of the address line 1 verification check. `pass` — matches the cardholder's address on file; `fail` — does not match; `unavailable` — verification could not be performed; `unchecked` — no address was provided for verification.
          - `address_postal_code_check` 'fail' | 'pass' | 'unavailable' | 'unchecked': Result of the postal code verification check. `pass` — matches the cardholder's postal code on file; `fail` — does not match; `unavailable` — verification could not be performed; `unchecked` — no postal code was provided for verification.
          - `bin_details` BinDetails, nullable: BIN (Bank Identification Number) details for a card. bin_details are not guaranteed to be present on every card payment method — availability depends on the card network and issuer. When unavailable, this field will be null.
            - `type` string: Type of card issued, values include Credit, Debit, Prepaid, Unknown
            - `card_brand` string: Brand or network associated with card. Possible values include Visa, Mastercard, American Express, Discover
            - `card_class` string
            - `country` string: Long form country name which issued the card
            - `issuer` string: Issuing bank
            - `funding_source` string: Source of funds defined by BIN for a given card. Values include Charge, Credit, Debit, Deferred Debit (Visa Only), Network Only, Prepaid
        - `customer_id` string, nullable: id of the customer associated with the payment method
        - `signature` string, nullable: signature that uniquely identifies a credit card or bank account across payment methods
        - `account_id` string, nullable: account id associated with payment method
      - BankAccountPaymentMethodWithStatus
        - `id` string: unique id of the payment method
        - `status` string: signals whether the payment method is valid or invalid
        - `invalid_reason` string, nullable: informs reason that the payment method has been marked invalid, if status is invalid
        - `payment_method_import_id` string, nullable: id of the payment method import that created this payment method, if it was imported
        - `created_at` string, date-time
        - `updated_at` string, date-time
        - `bank_account` BankAccount
          - `id` string, uuid: unique bank account payment method id
          - `account_owner_name` string: account owner name
          - `account_type` string: type of account (checking, savings, etc.)
          - `bank_name` string, nullable: bank name
          - `acct_last_four` string: last 4 digits of the account number
          - `token` string: same value as unique bank account id; can be saved and used to process multiple payments with the same bank account
          - `metadata` object, nullable: any useful information you'd like to store alongside this bank account
        - `customer_id` string, nullable: id of the customer associated with the payment method
        - `signature` string, nullable: signature that uniquely identifies a credit card or bank account across payment methods
        - `account_id` string, nullable: account id associated with payment method
      - CardPresentPaymentMethod
        - `id` string: unique id of the payment method
        - `status` string: signals whether the payment method is valid or invalid
        - `invalid_reason` string, nullable: informs reason that the payment method has been marked invalid, if status is invalid
        - `payment_method_import_id` string, nullable: id of the payment method import that created this payment method, if it was imported
        - `created_at` string, date-time
        - `updated_at` string, date-time
        - `card_present` object
          - `id` string, uuid: unique card present payment method id
          - `brand` string: card brand or institution
          - `cardholder_name` string: name of the cardholder
          - `last4` string: last 4 digits of the card number
          - `expiry` string: card expiration date in MM/YY format
          - `type` string: the payment method type
        - `customer_id` string, nullable: id of the customer associated with the payment method
        - `signature` string, nullable: signature that uniquely identifies a credit card or bank account across payment methods
        - `account_id` string, nullable: account id associated with payment method
  - `page_info` PageInfo
    - `end_cursor` string: the encoded id of the last record in the current list
    - `has_next` boolean: true if the collection contains records following the current list
    - `has_previous` boolean: true if the collection contains records ahead of the current list
    - `start_cursor` string: the encoded id of the first record in the current list

---

[API](https://skmtc.dev/justifi/apis/justifi-api-documentation.md) - [All operations](https://skmtc.dev/justifi/apis/justifi-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/justifi/apis/justifi-api-documentation/revisions/dd9f3fed7e46?raw)