---
title: "Retrieve a Digital Wallet Token Request"
method: GET
path: "/digital_wallet_token_requests/{digital_wallet_token_request_id}"
---

# Retrieve a Digital Wallet Token Request

`GET /digital_wallet_token_requests/{digital_wallet_token_request_id}`

## Request

- Base URL: `https://api.increase.com`
- URL: `https://api.increase.com/digital_wallet_token_requests/{digital_wallet_token_request_id}`
- Auth: HTTP bearer

## Path parameters

- `digital_wallet_token_request_id` string, required: The identifier of the Digital Wallet Token Request.

## Response `200`

Digital Wallet Token Request

- DigitalWalletTokenRequest: A Digital Wallet Token Request is created each time a digital wallet app, such as Apple Pay or Google Pay, requests to tokenize a Card.
  - `card_id` string, required: The identifier of the Card the tokenization was requested for.
  - `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 Request was created.
  - `declined` object, nullable, required: Details of the decline. Present if and only if `outcome` is `declined`.
    - `reason` 'card_not_active' | 'no_verification_method' | 'webhook_timed_out' | 'webhook_declined' | 'incorrect_card_verification_code' | 'declined_by_token_requestor' | 'group_locked' | 'account_closed' | 'entity_not_active' | 'card_expiration_mismatch', required: The reason the tokenization was declined.
  - `device` object, required: The device that requested the tokenization.
    - `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".
  - `id` string, required: The Digital Wallet Token Request identifier.
  - `outcome` 'provisioned' | 'declined', required: The outcome of the tokenization request.
  - `provisioned` object, nullable, required: Details of the provisioned Digital Wallet Token. Present if and only if `outcome` is `provisioned`.
    - `digital_wallet_token_id` string, required: The identifier of the Digital Wallet Token that was provisioned.
  - `token_reference_identifier` string, required: The reference identifier assigned by the card network to the token.
  - `token_requestor` 'apple_pay' | 'google_pay' | 'samsung_pay' | 'garmin_pay' | 'unknown', required: The digital wallet app being used.
  - `type` 'digital_wallet_token_request', required: A constant representing the object's type. For this resource it will always be `digital_wallet_token_request`.

## Other responses

- `4XX`: Error
- `5XX`: Error

## Changes

- **2026-10-23** `46e3b28e8693`: 1 warning
  - added the new `card_expiration_mismatch` enum value to the `declined/anyOf[subschema #1: Digital Wallet Token Request Declined]/reason` response property for the response status `200`
- **2026-09-29** `08607688ab34`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/increase/apis/increase-api-2/changes/digital_wallet_token_requests/:digital_wallet_token_request_id/get.md)

---

[API](https://skmtc.dev/increase/apis/increase-api-2.md) - [All operations](https://skmtc.dev/increase/apis/increase-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/increase/apis/increase-api-2/revisions/efeb9b9f8ecc?raw)