---
title: "List Digital Wallet Tokens"
method: GET
path: "/cards/digital_wallet_tokens"
tags: ["Digital Wallet Tokens"]
---

# List Digital Wallet Tokens

`GET /cards/digital_wallet_tokens`

List Digital Wallet Tokens

NB: Digital wallet tokens cannot be created outside of production.

## Query parameters

- `page_token` string — Optional pagination token to be provided to retrieve subsequent pages, returned from previous get
- `limit` integer — Maximum number of objects to return per page. If the limit is greater than 100, then it will be set to 100.
- `token_state` 'ACTIVE' | 'REQUESTED' | 'REQUEST_DECLINED' | 'SUSPENDED' | 'TERMINATED' — Current status of the Digital Wallet Token
- `card_id` string, uuid — The unique identifier of a card

## Response `200`

List of Digital Wallet Tokens of a card

- TokenListResponse
  - `next_page_token` string — If returned, use the next_page_token to query for the next page of results. Not returned if there are no more rows.
  - `digital_wallet_tokens` DigitalWalletTokenResponse[], required — Array of Digital Wallet Token information of a Card
    - `approved_time` string, date-time
    - `card_id` string, uuid — Card ID of the Digital wallet Token
    - `device_id` string — The user’s Android device ID; the device’s unique identifier.
    - `device_type` 'APPLIANCE' | 'GAMING_DEVICE' | 'LAPTOP' | 'MOBILE_PHONE' | 'MOBILE_PHONE_OR_TABLET' | 'TABLET' | 'UNKNOWN' | 'VEHICLE' | 'WATCH' — Type of the device where the Digital Wallet Token is used in
    - `id` string, uuid — Digital Wallet Token ID
    - `last_modified_time` string, date-time
    - `processor_data` object — Raw data from processor.
    - `removed_from_wallet_time` string, date-time — The time that the token was removed from a wallet. Tokens make remain active after being removed from a wallet.
    - `requested_time` string, date-time
    - `state` 'ACTIVE' | 'REQUESTED' | 'REQUEST_DECLINED' | 'SUSPENDED' | 'TERMINATED' — Current status of the Digital Wallet Token
    - `token_reference_id` string — Unique identifier of the digital wallet token within the card network.
    - `type` string — Type of the Digital Wallet. Can be one of APPLE_PAY, ANDROID_PAY, SAMSUNG_PAY or something else when cards are added on file to a merchant.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden error
- `422` — Unprocessable entity request response
- `500` — Internal server error

---

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