---
title: "Retrieve a Digital Wallet Token"
method: GET
path: "/digital_wallet_tokens/{digital_wallet_token_id}"
---

# Retrieve a Digital Wallet Token

`GET /digital_wallet_tokens/{digital_wallet_token_id}`

## Path parameters

- `digital_wallet_token_id` string, required — The identifier of the Digital Wallet Token.

## Response `200`

Digital Wallet Token

- DigitalWalletToken — A Digital Wallet Token is created when a user adds a Card to their Apple Pay or Google Pay app. The Digital Wallet Token can be used for purchases just like a Card.
  - `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.
  - `decline` object, nullable, required — If the Digital Wallet Token was declined during provisioning, details about the decline.
    - `reason` 'card_not_active' | 'no_verification_method' | 'webhook_timed_out' | 'webhook_declined' | 'incorrect_card_verification_code' | 'declined_by_token_requestor', required — The reason the token provisioning was declined.
  - `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' | 'declined', 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' | 'declined', 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.

## Other responses

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

---

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