---
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 — Short unique identifier for the merchant for which the mandate is valid.
  - `created_at` string, date-time — The timestamp of when the payment instrument was created.

## 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.

## Changes

- **2026-07-10** `c75ca16e1e44` — 1 info
  - the security scope `customers.read` was added to the endpoint's security scheme `oauth2`
- **2026-04-09** `0cd7388a9eda` — 2 warning
  - added the new `active` enum value to the `items/mandate/status` response property for the response status `200`
  - added the new `inactive` enum value to the `items/mandate/status` response property for the response status `200`
- **2026-03-11** `cd79d83b07e0` — 2 warning, 5 info
  - removed the optional property `error_code` from the response with the `401` status
  - removed the optional property `message` from the response with the `401` status
  - added the optional property `detail` to the response with the `401` status
  - added the optional property `instance` to the response with the `401` status
  - …3 more
- **2026-01-19** `e28f194df27e` — 10 warning
  - added the new `ALELO` enum value to the `items/card/type` response property for the response status `200`
  - added the new `CONECS` enum value to the `items/card/type` response property for the response status `200`
  - added the new `EFTPOS` enum value to the `items/card/type` response property for the response status `200`
  - added the new `GIROCARD` enum value to the `items/card/type` response property for the response status `200`
  - …6 more
- **2025-12-19** `bdda188d36dd` — 1 info
  - the response optional property `items/card/type` became not read-only for the status `200`

[Full history](https://skmtc.dev/sumup/apis/sumup-rest-api/changes/v0.1/customers/:customer_id/payment-instruments/get.md)

---

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