---
title: "List payment instruments"
method: GET
path: "/v0.1/customers/{customer_id}/payment-instruments"
tags: ["Customers"]
---

# List payment instruments

`GET /v0.1/customers/{customer_id}/payment-instruments`

Lists all payment instrument resources that are saved for an identified customer.

## Response `200`

Returns the list of saved payment instruments for the customer.

- PaymentInstrumentResponse[]
  - `token` string — Unique token identifying the saved payment card for a customer.
  - `active` boolean — Indicates whether the payment instrument is active and can be used for payments. To deactivate it, send a `DELETE` request to the resource endpoint.
  - `type` 'card' — Type of the payment instrument.
  - `card` object — Details of the payment card.
    - `last_4_digits` string — Last 4 digits of the payment card number.
    - `type` 'ALELO' | 'AMEX' | 'CONECS' | 'CUP' | 'DINERS' | 'DISCOVER' | 'EFTPOS' | 'ELO' | 'ELV' | 'GIROCARD' | 'HIPERCARD' | 'INTERAC' | 'JCB' | 'MAESTRO' | 'MASTERCARD' | 'PLUXEE' | 'SWILE' | 'TICKET' | 'VISA' | 'VISA_ELECTRON' | 'VISA_VPAY' | 'VPAY' | 'VR' | 'UNKNOWN' — Issuing card network of the payment card used for the transaction.
  - `mandate` MandateResponse — Details of the mandate linked to the saved payment instrument.
    - `type` string — Type of mandate stored for the checkout or payment instrument.
    - `status` 'active' | 'inactive' — Current lifecycle status of the mandate.
    - `merchant_code` string — Merchant account for which the mandate is valid.
  - `created_at` string, date-time — Creation date of payment instrument. Response format expressed according to [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) code.

## Other responses

- `401` — The request is not authorized.
- `403` — The request is authenticated but not permitted for this operation.
- `404` — The requested resource does not exist.

---

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