---
title: "Retrieve a paginated list of Payment Methods by query parameter(s)"
method: GET
path: "/payment-methods"
tags: ["Payment Methods"]
---

# Retrieve a paginated list of Payment Methods by query parameter(s)

`GET /payment-methods`

## Query parameters

- `payerId` string, uuid, required
- `offset` integer
- `limit` integer

## Headers

- `Trace-Id` string
- `End-User-Agent` string
- `End-User-Ip` string
- `End-User-OS` string
- `End-User-Device-Id` string
- `End-User-Device-Manufacturer` string
- `End-User-Device-Model` string

## Response `200`

A list of Payment Methods

- object
  - `data` PaymentMethod[]
    - `id` string, uuid
    - `externalId` string — Consumer defined ID that will be attached to this resource
    - `type` 'CARD' | 'BANK_ACCOUNT'
    - `data` union
      - object
        - `last4` string — Last 4 digits of card number
        - `brand` string
        - `expirationMonth` string
        - `expirationYear` string
        - `createdAt` string, date-time
        - `billingAddress` Address
          - `line1` string, required — Address line 1 (e.g., street, PO Box, or company name).
          - `line2` string — Address line 2 (e.g., apartment, suite, unit, or building).
          - `city` string, required — City, district, suburb, town, or village.
          - `state` string, required — State, county, province, or region.
          - `postalCode` string, required — ZIP or postal code.
          - `country` string, required — Two-letter country code (ISO 3166-1 alpha-2).
        - `subType` 'CREDIT' | 'DEBIT'
      - object
        - `accountType` 'CHECKING' | 'SAVINGS' — The type of the bank account
        - `accountHolderName` string — The legal name of the account holder
        - `createdAt` string, date-time
        - `accountLastFour` string — Last 4 digits of the account number
        - `routingNumber` string — The routing number of the bank account
        - `billingAddress` Address
          - `line1` string, required — Address line 1 (e.g., street, PO Box, or company name).
          - `line2` string — Address line 2 (e.g., apartment, suite, unit, or building).
          - `city` string, required — City, district, suburb, town, or village.
          - `state` string, required — State, county, province, or region.
          - `postalCode` string, required — ZIP or postal code.
          - `country` string, required — Two-letter country code (ISO 3166-1 alpha-2).
    - `status` 'ACTIVE' | 'INACTIVE' — In some cases Payment Method will remain Inactive until additional information provided
    - `statusReasons` StatusReason[]
      - `code` string, required
      - `message` string, required
  - `pagination` PaginationObject
    - `offset` integer
    - `limit` integer
    - `total` integer
    - `hasNextPage` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal Server Error

---

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