---
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`

## Request

- Base URL: `https://api.dintero.com/v1`
- URL: `https://api.dintero.com/v1/accounts/{aid}/wallets/customers/{customer_id}/cards`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/dintero/apis/account-management-api/docs/accounts/:aid/wallets/customers/:customer_id/cards/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/dintero/apis/account-management-api.md) - [All operations](https://skmtc.dev/dintero/apis/account-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dintero/apis/account-management-api/revisions/9b83a4199008?raw)