GET///
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 instead.
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 modelDefault 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
{
"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"
}
]
}