> ## Documentation Index > Fetch the complete documentation index at: https://polar.sh/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Customer Payment Methods by External ID > Get saved payment methods of a customer by external ID. **Scopes**: `customers:read` `customers:write` ## OpenAPI ````yaml get /v1/customers/external/{external_id}/payment-methods openapi: 3.1.0 info: title: Polar API summary: Polar HTTP and Webhooks API description: Read the docs at https://polar.sh/docs/api-reference version: 0.1.0 servers: - url: https://api.polar.sh description: Production environment x-speakeasy-server-id: production - url: https://sandbox-api.polar.sh description: Sandbox environment x-speakeasy-server-id: sandbox security: - access_token: [] tags: - name: public description: >- Endpoints shown and documented in the Polar API documentation and available in our SDKs. - name: private description: >- Endpoints that should appear in the schema only in development to generate our internal JS SDK. - name: mcp description: Endpoints enabled in the MCP server. paths: /v1/customers/external/{external_id}/payment-methods: get: tags: - customers - public - mcp summary: List Customer Payment Methods by External ID description: |- Get saved payment methods of a customer by external ID. **Scopes**: `customers:read` `customers:write` operationId: customers:list_payment_methods_external parameters: - name: external_id in: path required: true schema: type: string description: The customer external ID. title: External Id description: The customer external ID. - name: page in: query required: false schema: type: integer exclusiveMinimum: 0 description: Page number, defaults to 1. default: 1 title: Page description: Page number, defaults to 1. - name: limit in: query required: false schema: type: integer exclusiveMinimum: 0 description: Size of a page, defaults to 10. Maximum is 100. default: 10 title: Limit description: Size of a page, defaults to 10. Maximum is 100. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ListResource_PaymentMethod_' '404': description: Customer not found. content: application/json: schema: $ref: '#/components/schemas/ResourceNotFound' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' x-codeSamples: - lang: python label: Python (SDK) source: |- from polar_sdk import Polar with Polar( access_token="", ) as polar: res = polar.customers.list_payment_methods_external(external_id="", page=1, limit=10) while res is not None: # Handle items res = res.next() - lang: typescript label: Typescript (SDK) source: |- import { Polar } from "@polar-sh/sdk"; const polar = new Polar({ accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "", }); async function run() { const result = await polar.customers.listPaymentMethodsExternal({ externalId: "", }); for await (const page of result) { console.log(page); } } run(); components: schemas: ListResource_PaymentMethod_: properties: items: items: $ref: '#/components/schemas/PaymentMethod' title: PaymentMethod type: array title: Items pagination: $ref: '#/components/schemas/Pagination' type: object required: - items - pagination title: ListResource[PaymentMethod] ResourceNotFound: properties: error: type: string const: ResourceNotFound title: Error examples: - ResourceNotFound detail: type: string title: Detail type: object required: - error - detail title: ResourceNotFound HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError PaymentMethod: anyOf: - $ref: '#/components/schemas/CustomerPaymentMethodCard' - $ref: '#/components/schemas/CustomerPaymentMethodGeneric' Pagination: properties: total_count: type: integer title: Total Count max_page: type: integer title: Max Page type: object required: - total_count - max_page title: Pagination ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError CustomerPaymentMethodCard: properties: id: type: string format: uuid4 title: Id description: The ID of the object. created_at: type: string format: date-time title: Created At description: Creation timestamp of the object. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: Last modification timestamp of the object. processor: $ref: '#/components/schemas/PaymentProcessor' customer_id: type: string format: uuid4 title: Customer Id type: type: string const: card title: Type method_metadata: $ref: '#/components/schemas/PaymentMethodCardMetadata' is_default: type: boolean title: Is Default description: >- Whether this payment method is the customer's default payment method. examples: - true type: object required: - id - created_at - modified_at - processor - customer_id - type - method_metadata - is_default title: CustomerPaymentMethodCard CustomerPaymentMethodGeneric: properties: id: type: string format: uuid4 title: Id description: The ID of the object. created_at: type: string format: date-time title: Created At description: Creation timestamp of the object. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: Last modification timestamp of the object. processor: $ref: '#/components/schemas/PaymentProcessor' customer_id: type: string format: uuid4 title: Customer Id type: type: string title: Type is_default: type: boolean title: Is Default description: >- Whether this payment method is the customer's default payment method. examples: - false type: object required: - id - created_at - modified_at - processor - customer_id - type - is_default title: CustomerPaymentMethodGeneric PaymentProcessor: type: string enum: - stripe title: PaymentProcessor PaymentMethodCardMetadata: properties: brand: type: string title: Brand last4: type: string title: Last4 exp_month: type: integer title: Exp Month exp_year: type: integer title: Exp Year wallet: anyOf: - type: string - type: 'null' title: Wallet type: object required: - brand - last4 - exp_month - exp_year title: PaymentMethodCardMetadata securitySchemes: access_token: type: http scheme: bearer description: >- You can generate an **Organization Access Token** from your organization's settings. ````