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

# aid_cards_get

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

Get all cards for an account

scopes:
- admin:wallets
- read:wallets

## Path parameters

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

## Query parameters

- `limit` integer
- `starting_after` string
- `search` string
- `created_at.gte` string, isodate
- `created_at.lte` string, isodate
- `type` 'gift_card' | 'credit_note'
- `status` 'inactive' | 'unused' | 'partially_used' | 'used' | 'expired'
- `expires_at.gte` string, isodate
- `expires_at.lte` string, isodate
- `amount_balance` integer
- `amount_balance.gte` integer
- `amount_balance.lte` integer
- `amount_available` integer
- `amount_available.gte` integer
- `amount_available.lte` integer
- `currency` string[]
- `customer` string

## Response `200`

Collection of cards

- object
  - `cards` Card[], required
    - `brand` string — Visa, MasterCard, etc. The brand of the card.
    - `masked_pan` string
    - `expiry_date` string, \d{2}/\d{4}
    - `type` 'Credit' | 'Debit' | 'Credit Card' | 'Debit Card' | 'Prepaid'
    - `region` 'domestic' | 'eea' | 'eea-uk' | 'europe' | 'inter' — The region in which the transaction takes place, determined by location of merchant and issuer. * `domestic`: merchant and issuer within the same country. * `eea`: merchant and issuer within EEA, but not the same country. * `eea-uk`: merchant and issuer within EEA plus United Kingdom, but one or both not withing EEA. * `europe`: merchant and issuer within Europe, but one or both not within EEA plus United Kingdom. * `inter`: merchant and/or issuer not within Europe.
    - `country` string, iso-3166-1 — The country the card is issued in
    - `product_platform` 'consumer' | 'commercial'
    - `issuing_bank` string — The name of the bank that issued the card used
    - `acquirer_transaction_type` '3DSECURE' | 'SSL' — 3DSECURE or SSL. Indicates the transaction type of the acquirer.
    - `acquirer_stan` string — The System Trace Audit Number assigned by the acquirer to uniquely identify the transaction.
    - `acquirer_terminal_id` string — The ID of the acquirer terminal.
    - `acquirer_transaction_time` string, date-time — The ISO-8601 date and time of the acquirer transaction.
    - `authentication_status` 'Y' | 'A' | 'U' | 'N' — Y, A, U or N. Indicates the status of the authentication.
    - `three_ds_version` string
    - `three_ds_server_trans_id` string
    - `eci` string
    - `payment_system_type` string
    - `payment_token` string — The payment token generated by the authorization. Only available for transactions created from session where the generate_payment_token option is enabled in the session configuration, or from payment token sessions where payment_token is included in the token_provider.token_types - [POST /v1/sessions/payment-token](/api-reference/session/checkout_payment_token_session_post)
    - `payment_token_id` string — The id of the payment_token, only included in transaction where a payment_token was generated.
    - `recurrence_token` string — The recurrence token generated by the authorization. Only available for transactions created from session where the generate_recurrence_token option is enabled in the session configuration, or from payment token sessions where recurrence_token is included in the token_provider.token_types - [POST /v1/sessions/payment-token](/api-reference/session/checkout_payment_token_session_post)
    - `recurrence_token_id` string — The id of the recurrence_token, only included in transaction where a recurrence_token was generated.
    - `card_holder_tokenization_consent` 'opt_in' | 'opt_out' — The card holder's consent to tokenization, as provided during authorization. This is only a hint, and the final decision is made by the card issuer.
    - `entry_method` 'chip' | 'contactless' | 'magstripe' — How the card was read.
  - `starting_after` string — The cursor to use in the next request to get the next page of results

## Other responses

- `400` — Bad / Invalid request
- `401` — Access forbidden, invalid JWT token was used
- `403` — Forbidden
- `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)