---
title: "List Digital Wallet Tokens"
method: GET
path: "/digital_wallet_tokens"
---

# List Digital Wallet Tokens

`GET /digital_wallet_tokens`

## Query parameters

- `cursor` string — Return the page of entries after this one.
- `limit` integer — Limit the size of the list that is returned. The default (and maximum) is 100 objects.
- `card_id` string — Filter Digital Wallet Tokens to ones belonging to the specified Card.
- `created_at.after` string, date-time — Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.before` string, date-time — Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_after` string, date-time — Return results on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_before` string, date-time — Return results on or before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.

## Response `200`

Digital Wallet Token List

- DigitalWalletTokenList — A list of Digital Wallet Token objects.
  - `data` DigitalWalletToken[], required — The contents of the list.
    - `card_id` string, required — The identifier for the Card this Digital Wallet Token belongs to.
    - `cardholder` object, required — The cardholder information given when the Digital Wallet Token was created.
      - `name` string, nullable, required — Name of the cardholder, for example "John Smith".
    - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Digital Wallet Token was created.
    - `device` object, required — The device that was used to create the Digital Wallet Token.
      - `device_type` 'unknown' | 'mobile_phone' | 'tablet' | 'watch' | 'mobilephone_or_tablet' | 'pc' | 'household_device' | 'wearable_device' | 'automobile_device', nullable, required — Device type.
      - `identifier` string, nullable, required — ID assigned to the device by the digital wallet provider.
      - `ip_address` string, nullable, required — IP address of the device.
      - `name` string, nullable, required — Name of the device, for example "My Work Phone".
    - `dynamic_primary_account_number` object, nullable, required — The redacted Dynamic Primary Account Number.
      - `first6` string, required — The first 6 digits of the token's Dynamic Primary Account Number.
      - `last4` string, required — The last 4 digits of the token's Dynamic Primary Account Number.
    - `id` string, required — The Digital Wallet Token identifier.
    - `status` 'active' | 'inactive' | 'suspended' | 'deactivated', required — This indicates if payments can be made with the Digital Wallet Token.
    - `token_requestor` 'apple_pay' | 'google_pay' | 'samsung_pay' | 'unknown', required — The digital wallet app being used.
    - `type` 'digital_wallet_token', required — A constant representing the object's type. For this resource it will always be `digital_wallet_token`.
    - `updates` object[], required — Updates to the Digital Wallet Token.
      - `status` 'active' | 'inactive' | 'suspended' | 'deactivated', required — The status the update changed this Digital Wallet Token to.
      - `timestamp` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the update happened.
  - `next_cursor` string, nullable, required — A pointer to a place in the list. Pass this as the `cursor` parameter to retrieve the next page of results. If there are no more results, the value will be `null`.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/increase/apis/increase-api.md) · [All operations](https://skmtc.net/increase/apis/increase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api/versions/22125d715935/schema)
