> ## 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. # Update card > Updates the details of an existing card. PUT/cards/\{token} Updates the details of an existing card. ## URL path parameters | Fields | Description | | - | - | | token string Required | Unique identifier of the card you want to update. **Allowable Values:** Existing card token | ## Request body | Fields | Description | | - | - | | expedite boolean Optional | Set to `true` to request expedited processing of the card by your card fulfillment provider. This expedited service is available for cards fulfilled by [Perfect Plastic Printing](http://perfectplastic.com/), [IDEMIA](http://www.idemia.com), and [Arroweye Solutions](https://www.arroweye.com/). **NOTE:** Contact your Marqeta representative for information regarding the cost of expedited service. **Allowable Values:** `true`, `false` **Default value:** `false` | | fulfillment object Optional | Specifies certain physical characteristics of a card, as well as shipment information. **Allowable Values:** `card_fulfillment_reason`, `card_personalization`, `shipping` | | fulfillment.**card\_fulfillment\_reason** string Optional | Reason for card fulfillment. **Allowable Values:** `NEW`, `LOST_STOLEN`, `EXPIRED` | | fulfillment.**card\_personalization** object Required | Specifies personalized attributes to be added to the card. **Allowable Values:** `carrier`, `images`, `perso_type`, `text` | | fulfillment.card\_personalization.**carrier** object Optional | Specifies attributes of the card carrier. **Allowable Values:** `logo_file`, `logo_thumbnail_file`, `message_file`, `message_line`, `template_id` | | fulfillment.card\_personalization.carrier.**logo\_file** string Optional | Specifies an image to display on the card carrier. **Allowable Values:** Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.carrier.**logo\_thumbnail\_file** string Optional | Specifies a thumbnail-sized rendering of the image specified in the `logo_file` field. **Allowable Values:** Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.carrier.**message\_file** string Optional | Specifies a text file containing a custom message to print on the card carrier. **Allowable Values:** Contains the name of the text file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.carrier.**message\_line** string Optional | Specifies a custom message that appears on the card carrier. **Allowable Values:** 60 char max | | fulfillment.card\_personalization.carrier.**message\_line\_2** string Optional | Specifies the second line of a custom message that appears on the card carrier. **Allowable Values:** 60 char max | | fulfillment.card\_personalization.carrier.**template\_id** string Optional | Specifies the card carrier template to use. **Allowable Values:** Card carrier template ID | | fulfillment.card\_personalization.**images** object Optional | Specifies personalized images that appear on the card. **Allowable Values:** `card`, `carrier`, `carrier_return_window`, `signature` | | fulfillment.card\_personalization.images.**card** object Optional | Specifies personalized images that appear on the card. **Allowable Values:** `name`, `thermal_color` | | fulfillment.card\_personalization.images.card.**name** string Optional | Specifies a PNG image to display on the card. **Allowable Values:** Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.images.card.**thermal\_color** string Optional | Specifies the color of the image displayed on the card. **Allowable Values:** Contains the name of the color and must match one of the provider's predefined colors. | | fulfillment.card\_personalization.images.**carrier** object Optional | Specifies personalized images that appear on the card carrier. **Allowable Values:** `message_1`, `name` | | fulfillment.card\_personalization.images.carrier.**message\_1** string Optional | Specifies a custom message that appears on the card carrier. **Allowable Values:** 60 char max | | fulfillment.card\_personalization.images.carrier.**name** string Optional | Specifies a PNG image to display on the card carrier. **Allowable Values:** Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.images.**carrier\_return\_window** object Optional | Specifies a PNG image to display in the return address window of envelopes used for sending cards to cardholders. **Allowable Values:** `name` | | fulfillment.card\_personalization.images.carrier\_return\_window.**name** string Optional | Specifies a PNG image to display in the return address window of envelopes used for sending cards to cardholders. **Allowable Values:** Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.images.**signature** object Optional | Specifies a PNG image of the cardholder's signature. **Allowable Values:** `name` | | fulfillment.card\_personalization.images.signature.**name** string Optional | Specifies a PNG image of the cardholder's signature. **Allowable Values:** Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.**perso\_type** string Optional | Specifies the type of card personalization. **Allowable Values:** `EMBOSS`, `LASER`, `FLAT` | | fulfillment.card\_personalization.**text** object Required | Specifies personalized text that appears on the card. **Allowable Values:** `name_line_1`, `name_line_2`, `name_line_3` | | fulfillment.card\_personalization.text.**name\_line\_1** object Required | Specifies the first line of personalized text that appears on the card. **Allowable Values:** `name_line_1.value` 21 char max; if `name_line_1_numeric_postfix` is `true`, 14 char max. Strings longer than the character limit are truncated. | | fulfillment.card\_personalization.text.name\_line\_1.**value** string Optional | Line of personalized text printed on the card. **Allowable Values:** 21 char max | | fulfillment.card\_personalization.text.**name\_line\_2** object Optional | Specifies the second line of personalized text that appears on the card. **Allowable Values:** `name_line_2.value` | | fulfillment.card\_personalization.text.name\_line\_2.**value** string Optional | Line of personalized text printed on the card. **Allowable Values:** 21 char max | | fulfillment.card\_personalization.text.**name\_line\_3** object Optional | Specifies the third line of personalized text that appears on the card. **Allowable Values:** `name_line_3.value` | | fulfillment.card\_personalization.text.name\_line\_3.**value** string Optional | Line of personalized text printed on the card. **Allowable Values:** 21 char max | | fulfillment.**shipping** object Optional | Specifies shipping details for the order. **Allowable Values:** `care_of_line`, `method`, `recipient_address`, `return_address` | | fulfillment.shipping.**care\_of\_line** string Optional | Adds the specified value as a care of (C/O) line to the mailing carrier. **NOTE:** This field can be specified on cards, card products, and bulk card orders. If you specify this field at multiple levels, the order of precedence is: card, bulk card order, card product. **Allowable Values:** 255 char max | | fulfillment.shipping.**method** string Optional | Specifies the shipping service. **Allowable Values:** `LOCAL_MAIL`, `LOCAL_MAIL_PACKAGE`, `GROUND`, `TWO_DAY`, `OVERNIGHT`, `INTERNATIONAL`, `INTERNATIONAL_PRIORITY`, `LOCAL_PRIORITY`, `FEDEX_EXPEDITED`, `FEDEX_REGULAR`, `UPS_EXPEDITED`, `UPS_REGULAR`, `USPS_EXPEDITED`, `USPS_REGULAR` Shipping options vary by card provider. For details on the specific shipping companies and services offered by your card provider, contact your Marqeta representative. | | fulfillment.shipping.**recipient\_address** object Optional | Address to which the order will be shipped. In order to generate cards, a valid shipping address must be provided by one of these: - The card or bulk card order's `fulfillment.shipping.recipient_address` field - The users' `address` fields - The card product's `config.fulfillment.shipping.recipient_address` field The order of precedence from highest to lowest is card, user, card product. To be valid, an address must have the `address1`, `city`, `state`, and `postal_code` or `zip` fields populated. The `country` field defaults to USA if unpopulated. **Allowable Values:** Valid `recipient_address` object | | fulfillment.shipping.recipient\_address.**address1** string Optional | Number and street of the address. **Allowable Values:** 255 char max Limits lower than 255 characters may be imposed by providers. Perfect Plastic Printing and IDEMIA have a limit of 100 characters, and Arroweye Solutions has a limit of 50 characters. | | fulfillment.shipping.recipient\_address.**address2** string Optional | Additional address information. **Allowable Values:** 255 char max Limits lower than 255 characters may be imposed by providers. Perfect Plastic Printing and IDEMIA have a limit of 100 characters, and Arroweye Solutions has a limit of 50 characters. | | fulfillment.shipping.recipient\_address.**city** string Optional | City of the address. **Allowable Values:** 40 char max | | fulfillment.shipping.recipient\_address.**country** string Optional | Country of the address. **Allowable Values:** 40 char max English short name. For example, for the Kingdom of Spain, use the English short name "Spain". The ISO maintains the [full list of country codes](https://www.iso.org/obp/ui/#search/code/). | | fulfillment.shipping.recipient\_address.**first\_name** string Optional | First name of the addressee. **Allowable Values:** 40 char max | | fulfillment.shipping.recipient\_address.**last\_name** string Optional | Last name of the addressee. **Allowable Values:** 40 char max | | fulfillment.shipping.recipient\_address.**middle\_name** string Optional | Middle name of the addressee. **Allowable Values:** 40 char max | | fulfillment.shipping.recipient\_address.**phone** string Optional | Telephone number of the addressee. **Allowable Values:** 20 char max | | fulfillment.shipping.recipient\_address.**postal\_code** string Optional | Postal code of the address. **Allowable Values:** 10 char max | | fulfillment.shipping.recipient\_address.**state** string Optional | State of the address. **Allowable Values:** 32 char max | | fulfillment.shipping.recipient\_address.**zip** string Optional | United States ZIP code of the address. **Allowable Values:** 10 char max | | fulfillment.shipping.**return\_address** object Optional | Address to which the order will be returned if shipping fails. **Allowable Values:** `address1`, `address2`, `city`, `country`, `first_name`, `last_name`, `middle_name`, `phone`, `postal_code`, `state`, `zip` | | fulfillment.shipping.return\_address.**address1** string Optional | Number and street of the address. **Allowable Values:** 255 char max Limits lower than 255 characters may be imposed by providers. Perfect Plastic Printing and IDEMIA have a limit of 100 characters, and Arroweye Solutions has a limit of 50 characters. | | fulfillment.shipping.return\_address.**address2** string Optional | Additional address information. **Allowable Values:** 255 char max Limits lower than 255 characters may be imposed by providers. Perfect Plastic Printing and IDEMIA have a limit of 100 characters, and Arroweye Solutions has a limit of 50 characters. | | fulfillment.shipping.return\_address.**city** string Optional | City of the address. **Allowable Values:** 40 char max | | fulfillment.shipping.return\_address.**country** string Optional | Country of the address. **Allowable Values:** 40 char max English short name. For example, for the Kingdom of Spain, use the English short name "Spain". The ISO maintains the [full list of country codes](https://www.iso.org/obp/ui/#search/code/). | | fulfillment.shipping.return\_address.**first\_name** string Optional | First name of the addressee. **Allowable Values:** 40 char max | | fulfillment.shipping.return\_address.**last\_name** string Optional | Last name of the addressee. **Allowable Values:** 40 char max | | fulfillment.shipping.return\_address.**middle\_name** string Optional | Middle name of the addressee. **Allowable Values:** 40 char max | | fulfillment.shipping.return\_address.**phone** string Optional | Telephone number of the addressee. **Allowable Values:** 20 char max | | fulfillment.shipping.return\_address.**postal\_code** string Optional | Postal code of the address. **Allowable Values:** 10 char max | | fulfillment.shipping.return\_address.**state** string Optional | State of the address. **Allowable Values:** 32 char max | | fulfillment.shipping.return\_address.**zip** string Optional | United States ZIP code of the address. **Allowable Values:** 10 char max | | metadata object Optional | Associates customer-provided metadata with the card. **Allowable Values:** Contains the names and values of up to 20 fields in the format `"my_name_1": "my_value_1"` | | token string Required | Unique identifier of the card you want to update. Send a `GET` request to `/cards` to retrieve card tokens. **Allowable Values:** 1–36 chars Existing card token | | user\_token string Optional | Specifies the user you want to associate with the card. Send a `GET` request to `/users` to retrieve user tokens. **Allowable Values:** 1–36 chars Existing user token. | ## Sample request body ```json JSON lines wrap theme={null} { "token": "my_card_token_03", "user_token": "my_user_03" } ``` ## Response body | Fields | Description | | - | - | | activation\_actions object Conditionally returned | Defines actions to execute when the card is activated. The fields in this object are mutually exclusive. **Allowable Values:** `swap_digital_wallet_tokens_from_card_token`, `terminate_reissued_source_card` | | activation\_actions.**swap\_digital\_wallet\_tokens\_from\_card\_token** string Conditionally returned | Moves all digital wallet tokens from the specified card to the new card. Not relevant when `reissue_pan_from_card_token` is set. Send a `GET` request to `/cards/user/{token}` to retrieve card tokens for a particular user. **Allowable Values:** 1–36 chars Existing card token | | activation\_actions.**terminate\_reissued\_source\_card** boolean Conditionally returned | If you are reissuing a card, the source card is terminated by default. To prevent the source card from being terminated, set this field to `false`. Only relevant when `reissue_pan_from_card_token` is set. **Allowable Values:** `true`, `false` **Default value:** `true` | | barcode string Returned | Barcode printed on the card, expressed as numerals. **Allowable Values:** 10-20 chars | | bulk\_issuance\_token string Conditionally returned | Unique identifier of the bulk card order. **Allowable Values:** 1-36 chars | | card\_product\_token string Returned | Unique identifier of the card product. **Allowable Values:** 1-36 chars | | chip\_cvv\_number string Conditionally returned | Three-digit card verification value (ICVV) stored on the chip of the card. **Allowable Values:** 3 chars | | contactless\_exemption\_counter integer Conditionally returned | Running count of the contactless transactions successfully completed since the last strong customer authentication (SCA) challenge was issued. You can limit the number of contactless transactions that can be performed without issuing an SCA challenge at the card product level. For more information about strong customer authentication, see [Card Products](https://www.marqeta.com/docs/core-api/card-products/). **Allowable Values:** Any integer | | contactless\_exemption\_total\_amount decimal Conditionally returned | Running total of the money spent in contactless transactions successfully completed since the last strong customer authentication (SCA) challenge was issued. You can limit the total amount that can be spent in contactless transactions without issuing an SCA challenge at the card product level. For more information about strong customer authentication, see [Card Products](https://www.marqeta.com/docs/core-api/card-products/). **Allowable Values:** Any integer | | contactless\_exemption\_transaction\_currency string Conditionally returned | Indicates the currency type of the transaction. **Allowable Values:** Valid three-character [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html) | | created\_time datetime Returned | Date and time when the resource was created, in UTC. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | cvv\_number string Conditionally returned | Three-digit card verification value (CVV2 or CVC2) printed on the card. **Allowable Values:** 3 chars | | expedite boolean Conditionally returned | A value of `true` indicates that you requested expedited processing of the card from your card fulfillment provider. **Allowable Values:** `true`, `false` | | expiration string Returned | Expiration date in `MMyy` format. **Allowable Values:** Format: MMyy | | expiration\_time datetime Returned | Expiration date and time, in UTC. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | fulfillment object Conditionally returned | Determines physical characteristics of a card and shipment information. **Allowable Values:** `card_fulfillment_reason`, `card_personalization`, `shipping` | | fulfillment.**card\_fulfillment\_reason** string Conditionally returned | Descriptive reason for the card fulfillment. **Allowable Values:** `NEW`, `LOST_STOLEN`, `EXPIRED` | | fulfillment.**card\_personalization** object Returned | Specifies personalized attributes to be added to the card. **Allowable Values:** `carrier`, `images`, `perso_type`, `text` | | fulfillment.card\_personalization.**carrier** object Conditionally returned | Specifies attributes of the card carrier. **Allowable Values:** `logo_file`, `logo_thumbnail_file`, `message_file`, `message_line`, `template_id` | | fulfillment.card\_personalization.carrier.**logo\_file** string Conditionally returned | Specifies an image to display on the card carrier. **Allowable Values:** Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.carrier.**logo\_thumbnail\_file** string Conditionally returned | Specifies a thumbnail-sized rendering of the image specified in the `logo_file` field. **Allowable Values:** Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.carrier.**message\_file** string Conditionally returned | Specifies a text file containing a custom message to print on the card carrier. **Allowable Values:** Contains the name of the text file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.carrier.**message\_line** string Conditionally returned | Specifies a custom message that appears on the card carrier. **Allowable Values:** 60 char max | | fulfillment.card\_personalization.carrier.**message\_line\_2** string Conditionally returned | Specifies the second line of a custom message that appears on the card carrier. **Allowable Values:** 60 char max | | fulfillment.card\_personalization.carrier.**template\_id** string Conditionally returned | Specifies the card carrier template to use. **Allowable Values:** Card carrier template ID | | fulfillment.card\_personalization.**images** object Conditionally returned | Specifies personalized images that appear on the card. **Allowable Values:** `card`, `carrier`, `carrier_return_window`, `signature` | | fulfillment.card\_personalization.images.**card** object Conditionally returned | Specifies personalized images that appear on the card. **Allowable Values:** `name`, `thermal_color` | | fulfillment.card\_personalization.images.card.**name** string Conditionally returned | Specifies a PNG image to display on the card. **Allowable Values:** Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.images.card.**thermal\_color** string Conditionally returned | Specifies the color of the image displayed on the card. **Allowable Values:** Contains the name of the color and must match one of the provider's predefined colors. | | fulfillment.card\_personalization.images.**carrier** object Conditionally returned | Specifies personalized images that appear on the card carrier. **Allowable Values:** `message_1`, `name` | | fulfillment.card\_personalization.images.carrier.**message\_1** string Conditionally returned | Specifies a custom message that appears on the card carrier. **Allowable Values:** 60 char max | | fulfillment.card\_personalization.images.carrier.**name** string Conditionally returned | Specifies a PNG image to display on the card carrier. **Allowable Values:** Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.images.**carrier\_return\_window** object Conditionally returned | Specifies a PNG image to display in the return address window of envelopes used for sending cards to cardholders. **Allowable Values:** `name` | | fulfillment.card\_personalization.images.carrier\_return\_window.**name** string Conditionally returned | Specifies a PNG image to display in the return address window of envelopes used for sending cards to cardholders. **Allowable Values:** Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.images.**signature** object Conditionally returned | Specifies a PNG image of the cardholder's signature. **Allowable Values:** `name` | | fulfillment.card\_personalization.images.signature.**name** string Conditionally returned | Specifies a PNG image of the cardholder's signature. **Allowable Values:** Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.**perso\_type** string Conditionally returned | Specifies the type of card personalization. **Allowable Values:** `EMBOSS`, `LASER`, `FLAT` | | fulfillment.card\_personalization.**text** object Returned | Specifies personalized text that appears on the card. **Allowable Values:** `name_line_1`, `name_line_2`, `name_line_3` | | fulfillment.card\_personalization.text.**name\_line\_1** object Returned | Specifies the first line of personalized text that appears on the card. **Allowable Values:** `name_line_1.value` 21 char max; if `name_line_1_numeric_postfix` is `true`, 14 char max. Strings longer than the character limit are truncated. | | fulfillment.card\_personalization.text.name\_line\_1.**value** string Conditionally returned | Line of personalized text printed on the card. **Allowable Values:** 21 char max | | fulfillment.card\_personalization.text.**name\_line\_2** object Conditionally returned | Specifies the second line of personalized text that appears on the card. **Allowable Values:** `name_line_2.value` | | fulfillment.card\_personalization.text.name\_line\_2.**value** string Conditionally returned | Line of personalized text printed on the card. **Allowable Values:** 21 char max | | fulfillment.card\_personalization.text.**name\_line\_3** object Conditionally returned | Specifies the third line of personalized text that appears on the card. **Allowable Values:** `name_line_3.value` | | fulfillment.card\_personalization.text.name\_line\_3.**value** string Conditionally returned | Line of personalized text printed on the card. **Allowable Values:** 21 char max | | fulfillment.**shipping** object Conditionally returned | Specifies shipping details for the order. This object is returned if it exists in the resource. **Allowable Values:** `care_of_line`, `method`, `recipient_address`, `return_address` | | fulfillment.shipping.**care\_of\_line** string Conditionally returned | Specifies the value of the care of (C/O) line on the mailing carrier. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | fulfillment.shipping.**method** string Conditionally returned | Specifies the shipping service. This field is returned if it exists in the resource. **Allowable Values:** `LOCAL_MAIL`, `LOCAL_MAIL_PACKAGE`, `GROUND`, `TWO_DAY`, `OVERNIGHT`, `INTERNATIONAL`, `INTERNATIONAL_PRIORITY`, `LOCAL_PRIORITY`, `FEDEX_EXPEDITED`, `FEDEX_REGULAR`, `UPS_EXPEDITED`, `UPS_REGULAR`, `USPS_EXPEDITED`, `USPS_REGULAR` | | fulfillment.shipping.**recipient\_address** object Conditionally returned | Address to which the order will be shipped. This field is returned if it exists in the resource. **Allowable Values:** Existing `recipient_address` object | | fulfillment.shipping.recipient\_address.**address1** string Conditionally returned | Number and street of the address. This field is returned if it exists in the resource. **Allowable Values:** 255 char max Limits lower than 255 characters may be imposed by providers. Perfect Plastic Printing and IDEMIA have a limit of 100 characters, and Arroweye Solutions has a limit of 50 characters. | | fulfillment.shipping.recipient\_address.**address2** string Conditionally returned | Additional address information. This field is returned if it exists in the resource. **Allowable Values:** 255 char max Limits lower than 255 characters may be imposed by providers. Perfect Plastic Printing and IDEMIA have a limit of 100 characters, and Arroweye Solutions has a limit of 50 characters. | | fulfillment.shipping.recipient\_address.**city** string Conditionally returned | City of the address. This field is returned if it exists in the resource. **Allowable Values:** 40 char max | | fulfillment.shipping.recipient\_address.**country** string Conditionally returned | Country of the address. This field is returned if it exists in the resource. **Allowable Values:** 40 char max English short name. For example, for the Kingdom of Spain, use the English short name "Spain". The ISO maintains the [full list of country codes](https://www.iso.org/obp/ui/#search/code/). | | fulfillment.shipping.recipient\_address.**first\_name** string Conditionally returned | First name of the addressee. This field is returned if it exists in the resource. **Allowable Values:** 40 char max | | fulfillment.shipping.recipient\_address.**last\_name** string Conditionally returned | Last name of the addressee. This field is returned if it exists in the resource. **Allowable Values:** 40 char max | | fulfillment.shipping.recipient\_address.**middle\_name** string Conditionally returned | Middle name of the addressee. This field is returned if it exists in the resource. **Allowable Values:** 40 char max | | fulfillment.shipping.recipient\_address.**phone** string Conditionally returned | Telephone number of the addressee. This field is returned if it exists in the resource. **Allowable Values:** 20 char max | | fulfillment.shipping.recipient\_address.**postal\_code** string Conditionally returned | Postal code of the address. This field is returned if it exists in the resource. **Allowable Values:** 10 char max | | fulfillment.shipping.recipient\_address.**state** string Conditionally returned | State or province of the address. This field is returned if it exists in the resource. **Allowable Values:** 32 char max | | fulfillment.shipping.recipient\_address.**zip** string Conditionally returned | United States ZIP code of the address. This field is returned if it exists in the resource. **Allowable Values:** 10 char max | | fulfillment.shipping.**return\_address** object Conditionally returned | Address to which the order will be returned if shipping fails. This object is returned if it exists in the resource. **Allowable Values:** Existing `return_address` object | | fulfillment.shipping.return\_address.**address1** string Conditionally returned | Number and street of the address. This field is returned if it exists in the resource. **Allowable Values:** 255 char max Limits lower than 255 characters may be imposed by providers. Perfect Plastic Printing and IDEMIA have a limit of 100 characters, and Arroweye Solutions has a limit of 50 characters. | | fulfillment.shipping.return\_address.**address2** string Conditionally returned | Additional address information. This field is returned if it exists in the resource. **Allowable Values:** 255 char max Limits lower than 255 characters may be imposed by providers. Perfect Plastic Printing and IDEMIA have a limit of 100 characters, and Arroweye Solutions has a limit of 50 characters. | | fulfillment.shipping.return\_address.**city** string Conditionally returned | City of the address. This field is returned if it exists in the resource. **Allowable Values:** 40 char max | | fulfillment.shipping.return\_address.**country** string Conditionally returned | Country of the address. This field is returned if it exists in the resource. **Allowable Values:** 40 char max English short name. For example, for the Kingdom of Spain, use the English short name "Spain". The ISO maintains the [full list of country codes](https://www.iso.org/obp/ui/#search/code/). | | fulfillment.shipping.return\_address.**first\_name** string Conditionally returned | First name of the addressee. This field is returned if it exists in the resource. **Allowable Values:** 40 char max | | fulfillment.shipping.return\_address.**last\_name** string Conditionally returned | Last name of the addressee. This field is returned if it exists in the resource. **Allowable Values:** 40 char max | | fulfillment.shipping.return\_address.**middle\_name** string Conditionally returned | Middle name of the addressee. This field is returned if it exists in the resource. **Allowable Values:** 40 char max | | fulfillment.shipping.return\_address.**phone** string Conditionally returned | Telephone number of the addressee. This field is returned if it exists in the resource. **Allowable Values:** 20 char max | | fulfillment.shipping.return\_address.**postal\_code** string Conditionally returned | Postal code of the address. This field is returned if it exists in the resource. **Allowable Values:** 10 char max | | fulfillment.shipping.return\_address.**state** string Conditionally returned | State or province of the address. This field is returned if it exists in the resource. **Allowable Values:** 32 char max | | fulfillment.shipping.return\_address.**zip** string Conditionally returned | United States ZIP code of the address. This field is returned if it exists in the resource. **Allowable Values:** 10 char max | | fulfillment\_status string Returned | Card fulfillment status: - **ISSUED:** Initial state of all newly created/issued cards. - **ORDERED:** Card ordered through the card fulfillment provider. - **REORDERED:** Card reordered through the card fulfillment provider. - **REJECTED:** Card rejected by the card fulfillment provider. - **SHIPPED:** Card shipped by the 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. **Allowable Values:** `ISSUED`, `ORDERED`, `REORDERED`, `REJECTED`, `SHIPPED`, `DELIVERED`, `DIGITALLY_PRESENTED` | | instrument\_type string Conditionally returned | Instrument type of the card: - **PHYSICAL\_MSR:** A physical card with a magnetic stripe. This is the default physical card type. - **PHYSICAL\_ICC:** A physical card with an integrated circuit, or "chip." - **PHYSICAL\_CONTACTLESS:** A physical card that uses radio frequency identification (RFID) or near-field communication (NFC) to enable payment over a secure radio interface. - **PHYSICAL\_COMBO:** A physical card with a chip that also supports contactless payments. - **VIRTUAL\_PAN:** A virtual card with a primary account number (PAN). **Allowable Values:** `PHYSICAL_MSR`, `PHYSICAL_ICC`, `PHYSICAL_CONTACTLESS`, `PHYSICAL_COMBO`, `VIRTUAL_PAN` | | last\_four string Returned | Last four digits of the card primary account number (PAN). **Allowable Values:** 4 chars | | last\_modified\_time datetime Returned | Date and time when the resource was last modified, in UTC. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | metadata object Conditionally returned | Associates customer-provided metadata with the card. **Allowable Values:** Contains the names and values of up to 20 fields in the format `"my_name_1": "my_value_1"` | | pan string Returned | Primary account number (PAN) of the card. **Allowable Values:** 16 char max | | pin\_is\_set boolean Returned | Specifies if the personal identification number (PIN) has been set for the card. **Allowable Values:** 4 chars | | reissue\_pan\_from\_card\_token string Conditionally returned | Reissues the specified card (known as the "source" card). **Allowable Values:** Existing card token | | new\_pan\_from\_card\_token string Conditionally returned | Reissues the specified card (known as the "source" card) with a new primary account number (PAN). **Allowable Values:** Existing card token | | state string Returned | Indicates the state of the card. **Allowable Values:** `ACTIVE`, `SUSPENDED`, `TERMINATED`, `UNSUPPORTED`, `UNACTIVATED`, `LIMITED` | | state\_reason string Returned | Descriptive reason for why the card is in its current state. For example, "Card activated by cardholder". **Allowable Values:** 255 char max | | token string Returned | Unique identifier of the card. **Allowable Values:** Existing card token | | translate\_pin\_from\_card\_token string Conditionally returned | Copies the personal identification number (PIN) from the specified source card to the newly created card. **Allowable Values:** Existing card token | | user\_token string Returned | Unique identifier of the cardholder. **Allowable Values:** Existing user token | ## Sample response body ```json JSON expandable lines wrap theme={null} { "created_time": "2022-02-14T18:48:10Z", "last_modified_time": "2022-02-14T18:58:10Z", "token": "mytestcard01", "user_token": "my_user_01", "card_product_token": "my_cardproduct_01", "last_four": "8949", "pan": "1111115454548949", "expiration": "0221", "expiration_time": "2027-02-28T23:59:59Z", "barcode": "17469201908992951865", "pin_is_set": false, "state": "UNACTIVATED", "state_reason": "New card", "expedite": false, "fulfillment_status": "ISSUED", "fulfillment": { "shipping": { "method": "UPS_REGULAR", "return_address": { "address1": "123 Henry St", "address2": "Suite 101", "city": "Porterville", "state": "CA", "postal_code": "93257", "country": "US", "phone": "8315555555", "first_name": "Saki", "middle_name": "R", "last_name": "Dogger" }, "recipient_address": { "address1": "1234 Grove St", "city": "Berkeley", "state": "CA", "postal_code": "94702", "country": "US", "phone": "5105551212", "first_name": "Jane", "last_name": "Doe" } }, "card_personalization": { "text": { "name_line_1": { "value": "My card personalization line 1" }, "name_line_2": { "value": "My card personalization line 2" } }, "images": { "card": { "name": "my_card_logo.png", "thermal_color": "Black" }, "signature": { "name": "my_signature.png" }, "carrier_return_window": { "name": "my_return_address_image.png" } } } }, "instrument_type": "PHYSICAL_MSR", "metadata": { "my_name_1": "my_value_1" } } ``` ## Related topics - [Update card product](https://www.marqeta.com/docs/core-api/card-products/update-card-product.md) - [Update Card on Exception File](https://www.marqeta.com/docs/core-api/exception-file-update.md) - [Update card information for Click to Pay for Visa](https://www.marqeta.com/docs/core-api/digital-wallets-management/click-to-pay-visa/update-card-information-click-pay-visa.md) - [Card Products Overview](https://www.marqeta.com/docs/core-api/card-products.md) - [Create account card](https://www.marqeta.com/docs/core-api/credit-account-cards/create-account-card.md)