---
title: "aid_customers_cid_cards_get"
method: GET
path: "/accounts/{aid}/wallets/customers/{customer_id}/cards"
tags: ["customers"]
---

# aid_customers_cid_cards_get

`GET /accounts/{aid}/wallets/customers/{customer_id}/cards`

Get the cards active for a customer

scopes:
- admin:wallets
- read:wallets
- user:wallets

## Path parameters

- `aid` string, ^[PT]{1}\d{8}$, required
- `customer_id` string, required

## Query parameters

- `limit` integer
- `starting_after` string

## Response `200`

Card details

- CustomerCard[]
  - `id` string, uuid — An UUID that uniquely identifies the resource
  - `created_at` string, date-time — The date-time when the resource was created
  - `created_by` string — The ID of the user/client that created the resource
  - `metadata` object — A key-value JSON object to store any additional information. The dintero_* namespace for keys is reserved
  - `active_from` string, date-time — Optional time when the card is activated. No `drawdown` transaction will be allowed before if set. (`fund` transaction is allowed)
  - `expires_at` string, date-time — Optional expiration time for the card. No transaction will be allowed on an expired card
  - `originated_by` string — The reference to where the entity was created. (must not have trailing or leading spaces)
  - `card_id` string, required — The card id you have defined for the card. (must not have trailing or leading spaces)
  - `customer_id` string — The customer id you have defined as the owner of the card. (must not have trailing or leading spaces)
  - `name` string — Display name for the card
  - `type` 'gift_card' | 'credit_note' — The type of the card. The value is one of the following: - `gift_card` - a gift card - `credit_note` - a credit note Defaults to `gift_card`
  - `status` 'inactive' | 'unused' | 'used' | 'partially_used' | 'expired' — The status of the card. The value is one of the following: - `inactive` - Inactive card created by batch, needs to be activated - `unused` - the card is unused - `used` - the card has 0 balance - `partially_used` - the card has been used partially - `expired` - the card has expired Defaults to `unused`
  - `pin` object
    - `format` PinFormat — PIN format used for generation
      - `length` integer — The length of the PIN (exclusive length of the prefix).
      - `prefix` string — Prefix the PIN, the length of the prefix will affect the total length of the PIN.
      - `symbols` boolean — Allow characters like `@#$%` in the created PIN.
      - `numbers` boolean — Allow characters like `123456` in the created PIN.
      - `characters` boolean — Allow characters like `acbABC` in the created PIN.
      - `barcode` boolean — Include the PIN as a base64 encoded barcode image.

## Other responses

- `400` — Bad / Invalid request
- `401` — Access forbidden, invalid JWT token was used
- `403` — Forbidden
- `404` — Resource was not found
- `500` — Unexpected Error

---

[API](https://skmtc.net/dintero/apis/account-management-api.md) · [All operations](https://skmtc.net/dintero/apis/account-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dintero/account-management-api/versions/9b83a4199008/schema)