---
title: "Get Consent Cards by Customer Reference"
method: GET
path: "/v1/payment/consent/customers/{customer_reference}/cards"
tags: ["Consent Services"]
---

# Get Consent Cards by Customer Reference

`GET /v1/payment/consent/customers/{customer_reference}/cards`

## Request

- Base URL: `https://api-sandbox.koin.com.br`
- URL: `https://api-sandbox.koin.com.br/v1/payment/consent/customers/{customer_reference}/cards`
- Auth: none declared. Required headers: `Content-Type`, `Accept`

Returns the active stored cards (consent / card-on-file, RN-075) associated with a customer reference.

## Path parameters

- `customer_reference` string, required

## Headers

- `Content-Type` string, required
- `Accept` string, required

## Response `200`

Stored cards associated with the customer reference

- ConsentCard[]
  - `instrument_token` string: Instrument token that identifies the stored card.
  - `card` object
    - `bin` string: Card BIN (first digits).
    - `type` 'CREDIT' | 'DEBIT': Card type.
    - `brand` object
      - `name` string: Card brand name.

## Other responses

- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-11-03** `1e3734785750`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/koin/apis/payments-api/changes/v1/payment/consent/customers/:customer_reference/cards/get.md)

---

[API](https://skmtc.dev/koin/apis/payments-api.md) - [All operations](https://skmtc.dev/koin/apis/payments-api/llms.txt) - [OpenAPI document](https://skmtc.dev/koin/apis/payments-api/revisions/1e3734785750?raw)