{
"pan": "<string>",
"token": "<string>",
"barcode": "<string>",
"last_four": "<string>",
"card_token": "<string>",
"expiration": "<string>",
"pin_is_set": false,
"user_token": "<string>",
"expiration_time": "<string>",
"card_product_token": "<string>",
"card": {
"metadata": {}
},
"user": {
"metadata": {}
},
"reason": "<string>",
"expedite": false,
"signed_by": "<string>",
"occurred_at": "2026-07-30T08:15:00Z",
"created_time": "2023-11-07T05:31:56Z",
"status_detail": "arrived_at_facility",
"card_shipped_at": "2026-07-28T09:00:00Z",
"created_timestamp": "2023-11-07T05:31:56Z",
"last_scan_location": {
"city": "<string>",
"state": "<string>",
"country": "<string>",
"postal_code": "<string>"
},
"bulk_issuance_token": "<string>",
"attempted_delivery_at": "2026-07-31T14:30:00Z",
"estimated_delivery_date": "2026-08-15",
"new_pan_from_card_token": "<string>",
"reissue_pan_from_card_token": "<string>"
}Card Transitions Object
Describes the fields of the Card Transitions object.
A card transition, describing a single state or fulfillment-status change of a card, plus a snapshot of the card it applies to.
Primary account number (PAN) of the card.
This field cannot be set directly using the /cardtransitions endpoint. A card transition's type is managed by the Marqeta platform, based on the before and after state of the transition, as specified in the request's state field. * fulfillment.issued: Card was created/issued * state.activated: Card was activated * state.suspended: Card was suspended * state.reinstated: Card was reinstated from a suspended state * state.terminated: Card was terminated * state.limited: Card was limited * fulfillment.ordered: Card was ordered from the card fulfillment provider * fulfillment.reordered: Card was re-sent to the card fulfillment provider after a previous order * fulfillment.rejected: Card was rejected by the card fulfillment provider * fulfillment.shipped: Card was shipped by the card fulfillment provider * fulfillment.delivered: Card was delivered by the card fulfillment provider * fulfillment.digitally_presented: Card was digitally presented using the /cards/{token}/showpan endpoint; does not affect the delivery of physical cards * fulfillment.in_transit: The tracking provider reports the shipment is in transit * fulfillment.out_for_delivery: The tracking provider reports the shipment is out for delivery * fulfillment.failed: The tracking provider reports the delivery attempt failed * fulfillment.delayed: The tracking provider reports a carrier delay; the card's fulfillment status is unchanged
fulfillment.issued, state.activated, state.suspended, state.reinstated, state.terminated, state.limited, fulfillment.ordered, fulfillment.reordered, fulfillment.rejected, fulfillment.shipped, fulfillment.delivered, fulfillment.digitally_presented, fulfillment.in_transit, fulfillment.out_for_delivery, fulfillment.failed, fulfillment.delayed Indicates the state of the card.
ACTIVE, SUSPENDED, TERMINATED, UNACTIVATED, LIMITED Unique identifier of the card transition.
1 - 36The barcode printed on the card, expressed as digits.
The mechanism by which the transition was initiated. * ADMIN - Indicates that the card transition was initiated through the Marqeta Dashboard. * API - Indicates that the card transition was initiated by you through the Core API. Use this value when creating a card transition with an API POST request. * FRAUD - Indicates that either Marqeta or the card network has determined that the card is fraudulent. * IVR - Indicates that the card transition was initiated through your Interactive Voice Response system. * NETWORK - Indicates that the card transition was initiated by a network-triggered load activation. * SYSTEM - Indicates that the card transition was initiated by Marqeta. For example, Marqeta suspended the card due to excessive failed personal identification number (PIN) entries.
API, IVR, FRAUD, ADMIN, SYSTEM, NETWORK Last four digits of the card primary account number (PAN).
Unique identifier of the card.
1 - 36Expiration date in MMyy format.
Specifies if the personal identification number (PIN) has been set for the card.
Unique identifier of the cardholder.
1 - 36Expiration date and time in UTC format.
Unique identifier of the card product.
36Provides status information about the card related to order and delivery. * ISSUED: Initial state of all newly created/issued cards * ORDERED: Card ordered through card fulfillment provider * REORDERED: Card re-sent to the card fulfillment provider after a previous order * REJECTED: Card rejected by card fulfillment provider * SHIPPED: Card shipped by card fulfillment provider * DELIVERED: Card delivered by the card fulfillment provider. * DIGITALLY_PRESENTED: Card digitally presented using the /cards/{token}/showpan endpoint; does not affect the delivery of physical cards * IN_TRANSIT: The tracking provider reports the shipment is in transit. * OUT_FOR_DELIVERY: The tracking provider reports the shipment is out for delivery. * FAILED: The tracking provider reports the delivery attempt failed. * RETURNED: The tracking provider reports the shipment was returned to sender.
ISSUED, ORDERED, REORDERED, REJECTED, SHIPPED, DELIVERED, DIGITALLY_PRESENTED, IN_TRANSIT, OUT_FOR_DELIVERY, FAILED, RETURNED Associates customer-injected metadata with the card.
Show child attributes
Show child attributes
Contains customer-provided information about the cardholder that performed the transaction.
Show child attributes
Show child attributes
Additional information about the state change.
255A value of true indicates that you requested expedited processing of the card from your card fulfillment provider.
Name of the person who signed for the delivery. Present when the tracking provider records a signature.
Show child attributes
Show child attributes
When the event behind this transition happened: the ship date for a shipped transition, otherwise the carrier scan time (for example the scan that reported a delay or a failed delivery). Present when the transition has tracking data.
"2026-07-30T08:15:00Z"
A 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
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 Contains information about the user.
Show child attributes
Show child attributes
Date and time when the resource was created, in UTC.
Carrier's granular per-scan status detail. Present when the tracking provider supplies one for a fulfillment transition.
"arrived_at_facility"
When the tracking provider registered tracking for this shipment.
"2026-07-28T09:00:00Z"
Date and time when the resource was created. Expressed in UTC, with millisecond precision.
Carrier-reported location of the most recent tracking scan. Present when the tracking provider supplies a location for a fulfillment transition.
Show child attributes
Show child attributes
The unique identifier of the bulk card order.
When the carrier made its first delivery attempt. Present when the tracking provider records one.
"2026-07-31T14:30:00Z"
Estimated delivery date. Present when the tracking provider supplies one for a fulfillment transition.
"2026-08-15"
Reissues the specified ("source") card with a new primary account number (PAN).
Reissues the specified ("source") card.
Was this page helpful?