> ## Documentation Index > Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve digital wallet token transition > Use this endpoint to retrieve a specific digital wallet token transition. GET/digitalwallettokentransitions/\{token} > [!NOTE] > > Use this endpoint if Marqeta is your card issuer. > If you use Marqeta only for tokenization as a service, use the [Tokenization-as-a-Service endpoint](https://www.marqeta.com/docs/core-api/tokenization-as-a-service/digital-wallet-token-transitions-taas/retrieve-digital-wallet-token-transition.md) instead. Use this endpoint to retrieve a specific digital wallet token transition. This endpoint supports [field filtering](https://www.marqeta.com/docs/core-api/field-filtering.md). ## URL path parameters | Fields | Description | | - | - | | token string Required | Unique identifier of the digital wallet token (DWT) transition. **Allowable Values:** Existing DWT transition token | ## URL query parameters | Fields | Description | | - | - | | fields string Optional | Comma-delimited list of fields to return (`field_1,field_2`, and so on). Leave blank to return all fields. **Allowable Values:** Comma-delimited list of fields, or blank | ## Response body | Fields | Description | | - | - | | card\_swap object Conditionally returned | Contains identifiers for swapping digital wallet tokens between cards. **Allowable Values:** `new_card_token`, `previous_card_token` | | card\_swap.**new\_card\_token** string Returned | Unique identifier of the new card resource to which the digital wallet tokens are assigned. **Allowable Values:** 1–36 chars | | card\_swap.**previous\_card\_token** string Returned | Unique identifier of the existing card resource that has digital wallet tokens assigned to it. **Allowable Values:** 1–36 chars | | channel string Returned | Mechanism by which the transition was initiated. **Allowable Values:** `TOKEN_SERVICE_PROVIDER`, `DIGITAL_WALLET`, `API`, `IVR`, `FRAUD`, `ADMIN`, `SYSTEM`, `TOKEN_SERVICE_PROVIDER_API` | | created\_time datetime Conditionally returned | Date and time when the transition was created, in UTC. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | created\_timestamp string Conditionally returned | Date and time when the transition was created, in UTC, expressed to the millisecond. Use this field to order transitions that share the same whole-second `created_time`. Transitions created before this field was introduced might not include a `created_timestamp`. Fall back to `created_time` for those transitions. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ss.SSSZ | | digital\_wallet\_token object Returned | Contains identifiers of the digital wallet token resource and the card resource. **Allowable Values:** Unique identifiers of the digital wallet token resource and the card resource | | digital\_wallet\_token.**token** string Returned | Unique identifier of the digital wallet token resource. **Allowable Values:** 1–36 chars | | digital\_wallet\_token.**card\_token** string Conditionally returned | Unique identifier of the card resource to use for the provisioning request. **Allowable Values:** 1–36 chars | | fulfillment\_status string Returned | Provisioning status of the digital wallet token. **Allowable Values:** `DECISION_RED`, `DECISION_YELLOW`, `DECISION_GREEN`, `REJECTED`, `PROVISIONED` | | reason string Conditionally returned | Reason for the transition. **Allowable Values:** 255 char max | | reason\_code string Conditionally returned | Standard code describing the reason for the transition: - **00:** Object activated for the first time - **01:** Requested by you - **02:** Inactivity over time - **03:** This address cannot accept mail or the addressee is unknown - **04:** Negative account balance - **05:** Account under review - **06:** Suspicious activity was identified - **07:** Activity outside the program parameters was identified - **08:** Confirmed fraud was identified - **09:** Matched with an Office of Foreign Assets Control list - **10:** Card was reported lost - **11:** Card information was cloned - **12:** Account or card information was compromised - **13:** Temporary status change while on hold/leave - **14:** Initiated by Marqeta - **15:** Initiated by issuer - **16:** Card expired - **17:** Failed KYC - **18:** Changed to `ACTIVE` because information was properly validated - **19:** Changed to `ACTIVE` because account activity was properly validated - **20:** Change occurred prior to the normalization of reason codes - **21:** Initiated by a third party, often a digital wallet provider - **22:** PIN retry limit reached - **23:** Card was reported stolen - **24:** Address issue - **25:** Name issue - **26:** SSN issue - **27:** DOB issue - **28:** Email issue - **29:** Phone issue - **30:** Account/fulfillment mismatch - **31:** Other reason - **32:** Unblock request - **86:** Notification of death **Allowable Values:** `00`, `01`, `02`, `03`, `04`, `05`, `06`, `07`, `08`, `09`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30`, `31`, `32`, `86` | | state string Returned | Specifies the state to which the digital wallet token is transitioning. **Allowable Values:** `REQUESTED`, `REQUEST_DECLINED`, `ACTIVE`, `SUSPENDED`, `TERMINATED` | | token string Returned | Unique identifier of the digital wallet token transition, and not the identifier of the digital wallet token itself. **Allowable Values:** 1–36 chars | | type string Returned | Type of digital wallet token transition. `state.activated`, for example. **Allowable Values:** 36 char max | ## Sample response body ```json JSON expandable lines wrap theme={null} { "token": "my_transition_04", "digital_wallet_token": { "token": "my_digital_wallet_token_0987" }, "type": "state.activated", "channel": "API", "state": "ACTIVE", "fulfillment_status": "PROVISIONED", "reason": "Passed additional identity verification", "reason_code": "18", "created_time": "2026-02-23T18:57:45Z" } ``` ## Related topics - [Retrieve digital wallet token transition](https://www.marqeta.com/docs/core-api/tokenization-as-a-service/digital-wallet-token-transitions-taas/retrieve-digital-wallet-token-transition.md) - [Digital Wallet Token Transitions Overview](https://www.marqeta.com/docs/core-api/digital-wallets-management/digital-wallet-token-transitions-wallets.md) - [Digital Wallets Management Overview](https://www.marqeta.com/docs/core-api/digital-wallets-management.md) - [Tokenization-as-a-Service Overview](https://www.marqeta.com/docs/core-api/tokenization-as-a-service.md) - [List digital wallet token transitions](https://www.marqeta.com/docs/core-api/tokenization-as-a-service/digital-wallet-token-transitions-taas/list-digital-wallet-token-transitions.md)