---
title: "List customer payment methods by external ID"
method: GET
path: "/customers/external/{externalId}/payment-methods"
tags: ["customers"]
---

# List customer payment methods by external ID

`GET /customers/external/{externalId}/payment-methods`

## Request

- Base URL: `https://api.agentpaid.io/api/v1`
- URL: `https://api.agentpaid.io/api/v1/customers/external/{externalId}/payment-methods`
- Auth: HTTP bearer

Retrieves all payment methods associated with a customer identified by their external ID.

## Path parameters

- `externalId` string, required

## Response `200`

Success response

- PaymentMethod[]
  - `id` string: The payment method ID (typically from Stripe)
  - `type` 'card' | 'us_bank_account' | 'sepa_debit': The type of payment method
  - `card` PaymentMethodCard: Card details (present when type is 'card')
    - `brand` string: Card brand (visa, mastercard, amex, etc.)
    - `last4` string: Last 4 digits of the card number
    - `expMonth` integer: Expiration month (1-12)
    - `expYear` integer: Expiration year
  - `usBankAccount` PaymentMethodUsBankAccount: US bank account details (present when type is 'us_bank_account')
    - `bankName` string
    - `last4` string: Last 4 digits of the account number
    - `accountType` 'checking' | 'savings'
  - `isDefault` boolean: Whether this is the customer's default payment method
  - `createdAt` string, date-time

## Other responses

- `403`: Forbidden - Invalid or missing API key
- `404`: Customer not found

---

[API](https://skmtc.dev/paid/apis/paid-2.md) - [All operations](https://skmtc.dev/paid/apis/paid-2/llms.txt) - [OpenAPI document](https://skmtc.dev/paid/apis/paid-2/revisions/dbdf4a60ed27?raw)