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

# aid_customers_cid_card_cid_get

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

## Request

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

Get all details about a customer card 

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

## Path parameters

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

## Response `200`

Card details

- CustomerCardState
  - `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.
  - `tokens` object[]
    - `expires_at` string, date-time: expiration time for the token
    - `masked_code` string: masked token code
    - `format` Format: Specify the format to generate
      - `length` integer: The length of the token (exclusive length of the prefix)
      - `prefix` string: Prefix the token, the length of the prefix will affect the total length of the token
      - `symbols` boolean: Allow characters like `@#$%` in the created token
      - `numbers` boolean: Allow characters like `123456` in the created token
      - `characters` boolean: Allow characters like `acbABC` in the created token
      - `barcode` boolean: Include token as base64 encoded barcode image
  - `amount_balance` number: The balance, including amount locked by pending transaction. Monetary amount in smallest unit for the currency
  - `amount_available` number: The amount available for drawdown (exclusive amount locked by pending transactions). Monetary amount in smallest unit for the currency
  - `amount_funds` number: The sum of all fund transactions. Monetary amount in smallest unit for the currency
  - `amount_drawdown` number: The sum of all drawdown transactions. Monetary amount in smallest unit for the currency
  - `amount_pending` number: The sum of all pending transactions. Monetary amount in smallest unit for the currency
  - `amount_reserved` number: The sum of all reserved transactions. Monetary amount in smallest unit for the currency
  - `currency` 'NOK' | 'SEK' | 'DKK' | 'EUR' | 'USD': Three-character ISO-4217 currency. https://en.wikipedia.org/wiki/ISO_4217

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