> ## 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 digital wallet token transitions

> Use the /digitalwallettokentransitions/digitalwallettoken/{token} endpoint to return an array of all transitions for a particular digital wallet token.

GET/digitalwallettokentransitions/digitalwallettoken/\{token}

> [!NOTE]
>
> Use this endpoint if you use Marqeta only for tokenization as a service and are not a Marqeta card issuer.
> If Marqeta is your card issuer, use the [Digital Wallets Management endpoint](https://www.marqeta.com/docs/core-api/digital-wallets-management/digital-wallet-token-transitions-wallets/list-transitions-token.md) instead.

Use the `/digitalwallettokentransitions/digitalwallettoken/{token}` 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).

## Header parameter

| Fields | Description |
| - | - |
| req-sys-id string  Optional | Random pseudo-unique identifier of a request, used for troubleshooting between multiple parties. Usually a globally unique identifier (GUID). **Allowable Values:**  1–36 chars |

## URL path parameters

| Fields | Description |
| - | - |
| token string  Required | Unique identifier of the digital wallet token transition. **Allowable Values:**  Existing digital wallet token transition token |

## URL query parameters

| Fields | Description |
| - | - |
| count integer  Optional | Number of resources to retrieve. **Allowable Values:**  Any integer |
| start\_index integer  Optional | Sort order index of the first resource to retrieve. **Allowable Values:**  Any integer |
| 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:** `id` |
| 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 |
| - | - |
| count integer  Returned | Number of resources returned. This field is returned if there are resources in your returned array. **Allowable Values:**  Any integer |
| start\_index integer  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 |
| end\_index integer  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` |
| data array of objects  Conditionally returned | Array of digital wallet token transition objects. Objects are returned as appropriate to your query. **Allowable Values:**  Valid array of one or more digital wallet token transition objects |
| 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\[].**digital\_wallet\_token** object  Returned | Hashed version of Marqeta's unique identifier for the digital wallet tokens. **Allowable Values:**  `token` |
| data\[].digital\_wallet\_token.**token** string  Returned | Marqeta's unique identifier for the digital wallet token. **Allowable Values:**  1–36 chars |
| data\[].**card\_swap** object  Conditionally returned | Hashed version of the `card_swap` object. Specifies the old and new payment card tokens that were swapped. **Allowable Values:**  `newCardToken`, `previousCardToken` |
| data\[].card\_swap.**previousCardToken** string  Returned | Unique identifier of the old card from which the digital wallet tokens are transferred. **Allowable Values:**  1–36 chars |
| data\[].card\_swap.**newCardToken** string  Returned | Unique identifier of the new card to which the digital wallet tokens are transferred. **Allowable Values:**  1–36 chars |
| data\[].**type** string  Returned | Type of digital wallet token transition. `state.activated`, for example. **Allowable Values:**  `card.swap`, `fulfillment.requested`, `state.activated`, `state.reinstated`, `state.request_declined`, `state.suspended`, `state.terminated` |
| data\[].**channel** string  Returned | Mechanism by which the transition was initiated. `API`, for example. **Allowable Values:**  `ADMIN`, `API`, `DIGITAL_WALLET`, `FRAUD`, `IVR`, `MARQETA_DASHBOARD`, `SYSTEM`, `TOKEN_SERVICE_PROVIDER` |
| data\[].**state** string  Returned | Specifies the state to which to transition the digital wallet token. **Allowable Values:**  `ACTIVE`, `REQUESTED`, `REQUEST_DECLINED`, `SUSPENDED`, `TERMINATED` |
| data\[].**fulfillment\_status** string  Returned | Digital wallet token's provisioning status. **Allowable Values:**  `DECISION_GREEN`, `DECISION_RED`, `DECISION_YELLOW`, `PROVISIONED`, `REJECTED` |
| data\[].**reason** string  Conditionally returned | Descriptive reason for the transition. **Allowable Values:**  255 char max |
| data\[].**reason\_code** string  Returned | Code describing the reason for the transition. Marqeta does not validate what is provided, although Marqeta-sourced changes use standard codes. **Allowable Values:**  1–255 chars |
| data\[].**created\_time** datetime  Returned | Date and time when the resource was created, in UTC. **Allowable Values:**  date-time **Format:** yyyy-MM-ddThh:mm:ssZ |


## Related topics

- [Digital Wallet Token Transitions Overview](https://www.marqeta.com/docs/core-api/tokenization-as-a-service/digital-wallet-token-transitions-taas.md)
- [Tokenization-as-a-Service Overview](https://www.marqeta.com/docs/core-api/tokenization-as-a-service.md)
- [List transitions for digital wallet token](https://www.marqeta.com/docs/core-api/digital-wallets-management/digital-wallet-token-transitions-wallets/list-transitions-token.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)