---
title: "List Customer Payment Methods by External ID"
method: GET
path: "/v1/customers/external/{external_id}/payment-methods"
tags: ["customers", "public"]
---

# List Customer Payment Methods by External ID

`GET /v1/customers/external/{external_id}/payment-methods`

Get saved payment methods of a customer by external ID.

**Scopes**: `customers:read` `customers:write`

## Path parameters

- `external_id` string, required — The customer external ID.

## Query parameters

- `page` integer — Page number, defaults to 1.
- `limit` integer — Size of a page, defaults to 10. Maximum is 100.

## Response `200`

Successful Response

- ListResourcePaymentMethod
  - `items` PaymentMethod[], required
    - union
      - CustomerPaymentMethodCard
        - `id` string, uuid4, required — The ID of the object.
        - `created_at` string, date-time, required — Creation timestamp of the object.
        - `modified_at` string, date-time, nullable, required — Last modification timestamp of the object.
        - `processor` 'stripe', required
        - `customer_id` string, uuid4, required
        - `type` 'card', required
        - `method_metadata` PaymentMethodCardMetadata, required
          - `brand` string, required
          - `last4` string, required
          - `exp_month` integer, required
          - `exp_year` integer, required
          - `wallet` string, nullable
        - `is_default` boolean, required — Whether this payment method is the customer's default payment method.
      - CustomerPaymentMethodGeneric
        - `id` string, uuid4, required — The ID of the object.
        - `created_at` string, date-time, required — Creation timestamp of the object.
        - `modified_at` string, date-time, nullable, required — Last modification timestamp of the object.
        - `processor` 'stripe', required
        - `customer_id` string, uuid4, required
        - `type` string, required
        - `is_default` boolean, required — Whether this payment method is the customer's default payment method.
  - `pagination` Pagination, required
    - `total_count` integer, required
    - `max_page` integer, required

## Other responses

- `404` — Customer not found.
- `422` — Validation Error

---

[API](https://skmtc.net/polar/apis/polar-api.md) · [All operations](https://skmtc.net/polar/apis/polar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polar/polar-api/versions/964f974aceff/schema)