> ## 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. # List transitions for digital wallet token > Use this endpoint to return an array of all transitions for a particular digital wallet token. GET/digitalwallettokentransitions/digitalwallettoken/\{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/list-digital-wallet-token-transitions.md) instead. Use this endpoint to return an array of all transitions for a particular digital wallet token. This endpoint supports [field filtering](https://www.marqeta.com/docs/core-api/field-filtering.md), [pagination](https://www.marqeta.com/docs/core-api/sorting-and-pagination.md), and [sorting](https://www.marqeta.com/docs/core-api/sorting-and-pagination.md). ## URL path parameters | Fields | Description | | - | - | | token string Required | Unique identifier of the digital wallet token (DWT). **Allowable Values:** Existing DWT token | ## URL query parameters | Fields | Description | | - | - | | count integer Optional | Number of digital wallet transitions to retrieve. **Allowable Values:** Any integer **Default value:** 5 | | start\_index integer Optional | The sort order index of the first digital wallet token in the returned array. **Allowable Values:** Any integer **Default value:** 0 | | 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 | | sort\_by string Optional | Field on which to sort. Use any field in the resource model, or one of the system fields `lastModifiedTime` or `createdTime`. Prefix the field name with a hyphen (`-`) to sort in descending order. Omit the hyphen to sort in ascending order. **Allowable Values:** `createdTime`, `lastModifiedTime`, or any field in the resource model **Default value:** `-createdTime` | ## Response body | Fields | Description | | - | - | | count integer Conditionally returned | Number of resources returned. This field is returned if there are resources in your returned array. **Allowable Values:** Any integer | | data array of objects Conditionally returned | Array of digital wallet token transition resources. Resources are returned as appropriate to your query. **Allowable Values:** One or more digital wallet token transition resources | | data\[].**card\_swap** object Conditionally returned | Contains identifiers for swapping digital wallet tokens between cards. **Allowable Values:** `new_card_token`, `previous_card_token` | | data\[].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 | | data\[].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 | | data\[].**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` | | data\[].**created\_time** datetime Conditionally returned | Date and time when the transition was created, in UTC. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | data\[].**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 | | data\[].**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 | | data\[].digital\_wallet\_token.**token** string Returned | Unique identifier of the digital wallet token resource. **Allowable Values:** 1–36 chars | | data\[].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 | | data\[].**fulfillment\_status** string Returned | Provisioning status of the digital wallet token. **Allowable Values:** `DECISION_RED`, `DECISION_YELLOW`, `DECISION_GREEN`, `REJECTED`, `PROVISIONED` | | data\[].**reason** string Conditionally returned | Reason for the transition. **Allowable Values:** 255 char max | | data\[].**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` | | data\[].**state** string Returned | Specifies the state to which the digital wallet token is transitioning. **Allowable Values:** `REQUESTED`, `REQUEST_DECLINED`, `ACTIVE`, `SUSPENDED`, `TERMINATED` | | data\[].**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 | | data\[].**type** string Returned | Type of digital wallet token transition. `state.activated`, for example. **Allowable Values:** 36 char max | | end\_index integer Conditionally returned | Sort order index of the last resource in the returned array. This field is returned if there are resources in your returned array. **Allowable Values:** Any integer | | is\_more boolean Conditionally returned | A value of `true` indicates that more unreturned resources exist. A value of `false` indicates that no more unreturned resources exist. This field is returned if there are resources in your returned array. **Allowable Values:** `true`, `false` | | start\_index integer Conditionally returned | Sort order index of the first resource in the returned array. This field is returned if there are resources in your returned array. **Allowable Values:** Any integer | ## Sample response body ```json JSON expandable lines wrap theme={null} { "count": 2, "start_index": 0, "end_index": 1, "is_more": false, "data": [ { "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" }, { "token": "my_transition_04", "digital_wallet_token": { "token": "my_digital_wallet_token_0987" }, "type": "fulfillment.requested", "channel": "TOKEN_SERVICE_PROVIDER", "state": "REQUESTED", "fulfillment_status": "DECISION_YELLOW", "reason": "Additional identity verification required", "reason_code": "21", "created_time": "2026-02-23T18:44:21Z" } ] } ``` ## Related topics - [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) - [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) - [Retrieve digital wallet token transition](https://www.marqeta.com/docs/core-api/digital-wallets-management/digital-wallet-token-transitions-wallets/retrieve-token-transition.md) - [Create digital wallet token transition](https://www.marqeta.com/docs/core-api/digital-wallets-management/digital-wallet-token-transitions-wallets/create-token-transition.md)