# Retrieve a customer's payment methods

This is used to fetch a customer's payment methods

Endpoint: GET /customers/{customerId}/payment-methods
Version: 1.1.0
Security: secretApiKeyAuth

## Path parameters:

  - `customerId` (string, required)
    Customer whose payment methods to retrieve
    Example: "cus_01FCTS1XMKH9FF43CAFA4CXT3P"

## Response 200 fields (application/json):

  - `items` (array)

  - `items.id` (string)
    The ID of the payment method
    Example: "pmt_01G0EYVFR02KBBVE2YWQ8AKMGJ"

  - `items.type` (string)
    The type of the payment method
    Enum: "Card"

  - `items.card` (object)

  - `items.card.scheme` (string)
    Enum: "Visa", "Mastercard", "Amex"

  - `items.card.last4` (string)
    The last 4 digits of the card
    Example: "4242"

  - `items.card.expiryMonth` (string)
    The 2-digit expiry month of the card
    Example: "10"

  - `items.card.expiryYear` (string)
    The 4-digit expiry year of the card
    Example: "2024"

  - `items.billingAddress` (object,null)

  - `items.billingAddress.firstName` (string)
    The first name of the customer
    Example: "Nathan"

  - `items.billingAddress.lastName` (string)
    The last name of the customer
    Example: "Jones"

  - `items.billingAddress.lineOne` (string)
    First line of the address
    Example: "123 Test Street"

  - `items.billingAddress.lineTwo` (string)
    Second line of the address
    Example: "456 Lane"

  - `items.billingAddress.city` (string)
    The address city/town
    Example: "Manchester"

  - `items.billingAddress.country` (string, required)
    The two-character ISO country code
    Example: "GB"

  - `items.billingAddress.postalCode` (string, required)
    The postal code/zip of the address
    Example: "SP4 7DE"

  - `items.billingAddress.region` (string,null)
    The state/county/province/region Required if the address is in the US/Canada and must be a 2-character ISO state/province code
    Example: "NY"

  - `items.checks` (object,null)

  - `items.checks.avsResponseCode` (string,null)
    The response from Address Verification Service (AVS) that determines the match or  partial match of the customer's billing address.
Possible values:
- A - Partial Match (street address matches, postal/zip code does not match)
- B - Partial Match (street address matches, postal/zip code not verified)
- C - No Match (street address and postal/zip code not verified)
- D - Full Match (street address and postal/zip code match)
- F - Full Match (street address and postal/zip code match)
- G - Not Supported (address information not verified)
- I - No Match (address information not verified)
- M - Full Match (street address and postal/zip code match)
- N - No Match (neither street address not postal/zip code match)
- P - Partial Match (postal/zip code matches, street address not verified)
- R - System Unavailable (unable to perform verification)
- S - Not Supported (AVS currently not supported by issuer)
- U - System Unavailable (address information not verified due to no data from issuer)
- W - Partial Match (postal/zip code matches, street address does not match)
- X - Full Match (street address and postal/zip code match)
- Y - Full Match (street address and postal/zip code match)
- Z - Partial Match (postal/zip code matches, street address does not match)
    Example: "Y"

  - `items.checks.cvvResponseCode` (string,null)
    The response from the check on the Card Verification Value (CVV/CVV2/CVC)
Possible values:
- M - Match (Visa and MC)
- Y - Match (Amex)
- N - No Match
- P - Not Processed
- S - Should be on card
- U - Issuer does not participate
    Example: "M"

  - `items.customerId` (string,null)
    The Id of the customer this card belongs to (null if the payment-method is single-use)
    Example: "cus_01G0EYVFR02KBBVE2YWQ8AKMGJ"

  - `items.createdTimestamp` (integer)
    The epoch timestamp (seconds) when the payment method was created
    Example: 1470989538

## Response 404 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"

## Response 500 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"