> ## 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 card products

> Use this endpoint to list existing card products.

<div className="mb-4 flex items-center gap-2"><span className="rounded-lg font-bold px-1.5 py-0.5 text-sm leading-5 bg-green-400/20 text-green-700 dark:text-green-400">GET</span><span className="flex items-center gap-0.5 font-mono text-sm"><span className="text-gray-400">/</span><span className="font-medium text-gray-800 dark:text-white">{"cardproducts"}</span></span></div>

Use this endpoint to list existing card products.

This endpoint supports [pagination](/docs/core-api/sorting-and-pagination/).

<h2 id="_url_query_parameters">
  URL query parameters
</h2>

| Fields | Description |
| - | - |
| count<br />integer<br /> Optional | Number of resources to retrieve. Count can be between 1 - 10 items.<br /><br />**Allowable Values:**<br /> 1-10<br /><br />**Default value:**<br />5 |
| start\_index<br />integer<br /> Optional | The sort order index of the first resource in the returned array.<br /><br />**Allowable Values:**<br /> Any integer<br /><br />**Default value:**<br />0 |
| sort\_by<br />string<br /> 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.<br /><br />**Allowable Values:**<br /> `createdTime`, `lastModifiedTime`, or any field in the resource model<br /><br />**Default value:**<br />`-createdTime` |

<h2 id="_response_body_2">
  Response body
</h2>

| Fields | Description |
| - | - |
| count<br />integer<br /> Conditionally returned | Number of resources to retrieve.<br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /> 1-10 |
| data<br />array of objects<br /> Conditionally returned | Array of card product objects.<br />Objects are returned as appropriate to your query.<br /><br />**Allowable Values:**<br /> Valid array of one or more card product objects |
| data\[].**active**<br />boolean<br /> Conditionally returned | Indicates whether the card product is active.<br />This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`true` |
| data\[].**config**<br />object<br /> Conditionally returned | Defines the characteristics of the card product. Configurations are conditionally returned based on program setup.<br /><br />**Allowable Values:**<br /> `card_life_cycle`, `clearing_and_settlement`, `digital_wallet_tokenization`, `fulfillment`, `jit_funding`, `poi`, `selective_auth`, `special`, `transaction_controls` |
| data\[].config.**card\_life\_cycle**<br />object<br /> Conditionally returned | Defines characteristics of the lifecycle of cards of this card product type.<br /><br />**Allowable Values:**<br /> `activate_upon_issue`, `card_service_code`, `expiration_offset`, `reloadability`, `update_expiration_upon_activation` |
| data\[].config.card\_life\_cycle.**activate\_upon\_issue**<br />boolean<br /> Conditionally returned | A value of `true` indicates that cards of this card product type are active once they are issued.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.card\_life\_cycle.**card\_service\_code**<br />integer<br /> Conditionally returned | Sequence of three digits that defines various services, differentiates card usage in international or domestic interchange, designates personal identification number (PIN) and authorization requirements, and identifies card restrictions. The following values are commonly used:<br />**First digit**<br />- **1** — International interchange OK<br />- **2** — International interchange, use IC (chip) where feasible<br />- **5** — National interchange only except under bilateral agreement<br />- **6** — National interchange only except under bilateral agreement, use IC (chip) where feasible<br />- **7** — No interchange except under bilateral agreement (closed loop)<br />- **9** — Test<br />**Second digit**<br />- **0** — Normal<br />- **2** — Contact issuer via online means<br />- **4** — Contact issuer via online means except under bilateral agreement<br />**Third digit**<br />- **0** — No restrictions, PIN required<br />- **1** — No restrictions<br />- **2** — Goods and services only (no cash)<br />- **3** — ATM only, PIN required<br />- **4** — Cash only<br />- **5** — Goods and services only (no cash), PIN required<br />- **6** — No restrictions, use PIN where feasible<br />- **7** — Goods and services only (no cash), use PIN where feasible<br /><br />**Allowable Values:**<br /> 100 - 999<br /><br />**Default value:**<br />101 |
| data\[].config.card\_life\_cycle.**expiration\_offset**<br />object<br /> Conditionally returned | Specifies the length of time after the date of issue for which cards of this card product type are valid.<br /><br />**Allowable Values:**<br /> `min_offset`, `unit`, `value` |
| data\[].config.card\_life\_cycle.expiration\_offset.**min\_offset**<br />object<br /> Conditionally returned | Specifies the minimum length of time after the date of issue for which the cards are valid.<br /><br />**Allowable Values:**<br /> `unit`, `value` |
| data\[].config.card\_life\_cycle.expiration\_offset.min\_offset.**unit**<br />string<br /> Conditionally returned | Specifies the time unit of the `value` field.<br /><br />**Allowable Values:**<br /> `YEARS`, `MONTHS`, `DAYS`, `HOURS`, `MINUTES`, `SECONDS` |
| data\[].config.card\_life\_cycle.expiration\_offset.min\_offset.**value**<br />integer<br /> Conditionally returned | Specifies the number of time units (as defined by the `unit` field) for which cards of this card product type are valid. Cards expire `value` x `unit` after the date of issue.<br />This number is rounded as follows:<br />- **YEARS** – Rounds up to the last second of the last day of the month of expiration. For example, if the issue date is 1 Jan 2021 and `value = 1`, the cards expire on the last day of Jan 2022.<br />- **MONTHS** – Rounds up to the last second of the last day of the month of expiration. For example, if the issue date is 1 May 2022 and `value = 1`, the cards expire on the last day of June 2022.<br />- **DAYS** – Rounds up to the last second of the day of expiration.<br />- **HOURS**, **MINUTES**, **SECONDS** – No rounding.<br /><br />**Allowable Values:**<br /> Any positive integer<br /><br />**Default value:**<br />`4` |
| data\[].config.card\_life\_cycle.expiration\_offset.**unit**<br />string<br /> Conditionally returned | Specifies the units for the `value` field.<br /><br />**Allowable Values:**<br /> `YEARS`, `MONTHS`, `DAYS`, `HOURS`, `MINUTES`, `SECONDS`<br /><br />**Default value:**<br />`YEARS` |
| data\[].config.card\_life\_cycle.expiration\_offset.**value**<br />integer<br /> Conditionally returned | Specifies the number of time units (as defined by the `unit` field in this object) for which cards of this card product type are valid. In other words, cards expire `value` x `unit` after the date of issue.<br />This number is rounded as follows:<br />- **YEARS** – Rounds up to the last second of the last day of the month of expiration. For example, if the issue date is 1 Jan 2021 and `value = 1`, the cards expire on the last day of Jan 2022.<br />- **MONTHS** – Rounds up to the last second of the last day of the month of expiration. For example, if the issue date is 1 May 2022 and `value = 1`, the cards expire on the last day of June 2022.<br />- **DAYS** – Rounds up to the last second of the day of expiration.<br />- **HOURS**, **MINUTES**, **SECONDS** – No rounding.<br /><br />**Allowable Values:**<br /> Any positive integer<br /><br />**Default value:**<br />4 |
| data\[].config.card\_life\_cycle.**reloadability**<br />string<br /> Conditionally returned | Indicates if a card is reloadable.<br /><br />**Allowable Values:**<br /> `NON-RELOADABLE`, `RELOADABLE`, `SINGLE_USE_VIRTUAL` |
| data\[].config.card\_life\_cycle.**update\_expiration\_upon\_activation**<br />boolean<br /> Conditionally returned | Normally, the `expiration_offset` is measured from the date of issue. Set this field to `true` to measure `expiration_offset` from the date of activation instead.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.**clearing\_and\_settlement**<br />object<br /> Conditionally returned | Specifies the destination for overdraft funds.<br /><br />**Allowable Values:**<br /> `overdraft_destination` |
| data\[].config.clearing\_and\_settlement.**overdraft\_destination**<br />string<br /> Conditionally returned | Specifies the destination for overdraft funds.<br />This field does not apply if JIT Funding is enabled.<br /><br />**Allowable Values:**<br /> `GPA`, `MERCHANT_CAMPAIGN_ACCOUNT`, `GLOBAL_OVERDRAFT_ACCOUNT`<br /><br />**Default value:**<br />`GPA` |
| data\[].config.**digital\_wallet\_tokenization**<br />object<br /> Conditionally returned | Controls characteristics related to digital wallets.<br /><br />**Allowable Values:**<br /> `card_art_id`, `provisioning_controls` |
| data\[].config.digital\_wallet\_tokenization.**card\_art\_id**<br />string<br /> Conditionally returned | Specifies the digital wallet card art identifier for the card product. The card art identifier also includes card metadata, such as terms and conditions, card product information, contact information, Apple Pay requirements, Android Pay requirements, wallet profiles, rule sets, terminal profiles, authorization profiles, message profiles, and activation profiles.<br />Digital wallets display the card art after the initial token has been provisioned and activated. Digital wallet card art is updated for all wallets automatically whenever a tokenized card is reissued or replaced.<br />- If your card program is Managed by Marqeta, Marqeta populates this field on your behalf.<br />- If your card program is Powered by Marqeta, you can obtain the correct card art identifier directly from Visa or Mastercard.<br />If this field is left blank, your card product inherits the card art assigned to the account BIN range. For more information about this field, contact your Marqeta representative.<br /><br />**Allowable Values:**<br /> Valid identifiers are defined by Visa or Mastercard and vary by program:<br /> - For Visa card products, this identifier is a GUID called `profileID`.<br /> - For Mastercard card products, this identifier is a string called `ProductConfigID`. |
| data\[].config.digital\_wallet\_tokenization.**provisioning\_controls**<br />object<br /> Conditionally returned | Controls the provisioning of digital wallets.<br /><br />**Allowable Values:**<br /> Valid `provisioning_controls` object |
| data\[].config.digital\_wallet\_tokenization.provisioning\_controls.**in\_app\_provisioning**<br />object<br /> Conditionally returned | Controls the provisioning of digital wallets by a Marqeta customer's mobile application.<br /><br />**Allowable Values:**<br /> Valid `in_app_provisioning` object |
| data\[].config.digital\_wallet\_tokenization.provisioning\_controls.**manual\_entry**<br />object<br /> Conditionally returned | Controls the provisioning of digital wallets by manual entry, in which the cardholder manually enters the card's primary account number (PAN), card verification value (CVV2), and expiration date.<br /><br />**Allowable Values:**<br /> Valid `manual_entry` object |
| data\[].config.digital\_wallet\_tokenization.provisioning\_controls.**wallet\_provider\_card\_on\_file**<br />object<br /> Conditionally returned | Controls the provisioning of digital wallets where the digital wallet provider already has the card on file.<br /><br />**Allowable Values:**<br /> Valid `wallet_provider_card_on_file` object |
| data\[].config.digital\_wallet\_tokenization.provisioning\_controls.**web\_push\_provisioning**<br />object<br /> Conditionally returned | Specifies the digital wallet card art and program configuration identifiers at the card product level for Web Push Provisioning.<br /><br />**Allowable Values:**<br /> Valid `web_push_provisioning` object |
| data\[].config.digital\_wallet\_tokenization.provisioning\_controls.**dwt\_use\_card\_status\_during\_auth**<br />boolean<br /> Conditionally returned | If `true`, then digital wallet transactions are declined if the card associated with the digital wallet token is in either the `SUSPENDED` or `TERMINATED` state.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.**fulfillment**<br />object<br /> Conditionally returned | Determines physical characteristics of a card, along with its bulk shipment information.<br /><br />**Allowable Values:**<br /> `all_zero_card_security_code`, `allow_card_creation`, `bin_prefix`, `bulk_ship`, `card_personalization`, `enable_offline_pin`, `fulfillment_provider`, `package_id`, `pan_length`, `payment_instrument`, `shipping`, `uppercase_name_lines` |
| data\[].config.fulfillment.**all\_zero\_card\_security\_code**<br />boolean<br /> Conditionally returned | If `true`, an all zero code (000) is allowed as a valid value in an authorization request.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.fulfillment.**allow\_card\_creation**<br />boolean<br /> Conditionally returned | Controls the ability to create cards from this card product; `true` allows and `false` disallows the creation of cards.<br />**NOTE:** The card product's `active` field has no effect on card creation or the behavior of this field.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`true` |
| data\[].config.fulfillment.**bin\_prefix**<br />string<br /> Conditionally returned | Prefix of the bank identification number.<br /><br />**Allowable Values:**<br /> A six-digit number for the sandbox environment; a six- to nine-digit number is expected in production environments (see note below).<br /><br />**Default value:**<br />111111<br />**NOTE:** In the sandbox environment or when testing against OpenAPI (Swagger), this field must be set to `111111`. It is preferable to use eight- or nine-digit BIN prefixes in production environments. Contact your Marqeta representative for the appropriate value to use. |
| data\[].config.fulfillment.**bin\_issue\_country**<br />string<br /> Conditionally returned | Country of the card issuer.<br /><br />**Allowable Values:**<br /> A valid alpha-3 <a href="https://www.iso.org/iso-3166-country-codes.html" target="blank">ISO 3166 country code</a> |
| data\[].config.fulfillment.**bulk\_ship**<br />boolean<br /> Conditionally returned | Enables bulk ordering of cards of this card product type using the `/bulkissuances` endpoint.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.fulfillment.**card\_personalization**<br />object<br /> Returned | Allows personalized attributes to be added to the card product.<br /><br />**Allowable Values:**<br /> Valid `card_personalization` object |
| data\[].config.fulfillment.card\_personalization.**carrier**<br />object<br /> Conditionally returned | Specifies attributes of the card carrier.<br /><br />**Allowable Values:**<br /> `logo_file`, `logo_thumbnail_file`, `message_file`, `message_line`, `template_id` |
| data\[].config.fulfillment.card\_personalization.carrier.**logo\_file**<br />string<br /> Conditionally returned | Specifies an image to display on the card carrier.<br /><br />**Allowable Values:**<br /> Contains the name of the image file and must match the name of the file you send to your fulfillment provider. |
| data\[].config.fulfillment.card\_personalization.carrier.**logo\_thumbnail\_file**<br />string<br /> Conditionally returned | Specifies a thumbnail-sized rendering of the image specified in the `logo_file` field.<br /><br />**Allowable Values:**<br /> Contains the name of the image file and must match the name of the file you send to your fulfillment provider. |
| data\[].config.fulfillment.card\_personalization.carrier.**message\_file**<br />string<br /> Conditionally returned | Specifies a text file containing a custom message to print on the card carrier.<br /><br />**Allowable Values:**<br /> Contains the name of the text file and must match the name of the file you send to your fulfillment provider. |
| data\[].config.fulfillment.card\_personalization.carrier.**message\_line**<br />string<br /> Conditionally returned | Specifies a custom message that appears on the card carrier.<br /><br />**Allowable Values:**<br /> 60 char max |
| data\[].config.fulfillment.card\_personalization.carrier.**message\_line\_2**<br />string<br /> Conditionally returned | Specifies the second line of a custom message that appears on the card carrier.<br /><br />**Allowable Values:**<br /> 60 char max |
| data\[].config.fulfillment.card\_personalization.carrier.**template\_id**<br />string<br /> Conditionally returned | Specifies the card carrier template to use.<br /><br />**Allowable Values:**<br /> Card carrier template ID |
| data\[].config.fulfillment.card\_personalization.**images**<br />object<br /> Conditionally returned | Specifies personalized images that appear on the card.<br /><br />**Allowable Values:**<br /> `card`, `carrier`, `carrier_return_window`, `signature` |
| data\[].config.fulfillment.card\_personalization.images.**card**<br />object<br /> Conditionally returned | Specifies personalized images that appear on the card.<br /><br />**Allowable Values:**<br /> `name`, `thermal_color` |
| data\[].config.fulfillment.card\_personalization.images.card.**name**<br />string<br /> Conditionally returned | Specifies a PNG image to display on the card.<br /><br />**Allowable Values:**<br /> Contains the name of the image file and must match the name of the file you send to your fulfillment provider. |
| data\[].config.fulfillment.card\_personalization.images.card.**thermal\_color**<br />string<br /> Conditionally returned | Specifies the color of the image displayed on the card.<br /><br />**Allowable Values:**<br /> Contains the name of the color and must match one of the provider's predefined colors. |
| data\[].config.fulfillment.card\_personalization.images.**carrier**<br />object<br /> Conditionally returned | Specifies personalized images that appear on the card carrier.<br /><br />**Allowable Values:**<br /> `message_1`, `name` |
| data\[].config.fulfillment.card\_personalization.images.carrier.**message\_1**<br />string<br /> Conditionally returned | Specifies a custom message that appears on the card carrier.<br /><br />**Allowable Values:**<br /> 60 char max |
| data\[].config.fulfillment.card\_personalization.images.carrier.**name**<br />string<br /> Conditionally returned | Specifies a PNG image to display on the card carrier.<br /><br />**Allowable Values:**<br /> Contains the name of the image file and must match the name of the file you send to your fulfillment provider. |
| data\[].config.fulfillment.card\_personalization.images.**carrier\_return\_window**<br />object<br /> Conditionally returned | Specifies a PNG image to display in the return address window of envelopes used for sending cards to cardholders.<br /><br />**Allowable Values:**<br /> `name` |
| data\[].config.fulfillment.card\_personalization.images.carrier\_return\_window.**name**<br />string<br /> Conditionally returned | Specifies a PNG image to display in the return address window of envelopes used for sending cards to cardholders.<br /><br />**Allowable Values:**<br /> Contains the name of the image file and must match the name of the file you send to your fulfillment provider. |
| data\[].config.fulfillment.card\_personalization.images.**signature**<br />object<br /> Conditionally returned | Specifies a PNG image of the cardholder's signature.<br /><br />**Allowable Values:**<br /> `name` |
| data\[].config.fulfillment.card\_personalization.images.signature.**name**<br />string<br /> Conditionally returned | Specifies a PNG image of the cardholder's signature.<br /><br />**Allowable Values:**<br /> Contains the name of the image file and must match the name of the file you send to your fulfillment provider. |
| data\[].config.fulfillment.card\_personalization.**perso\_type**<br />string<br /> Conditionally returned | Specifies the type of card personalization.<br /><br />**Allowable Values:**<br /> `EMBOSS`, `LASER`, `FLAT` |
| data\[].config.fulfillment.card\_personalization.**text**<br />object<br /> Returned | Specifies personalized text that appears on the card.<br /><br />**Allowable Values:**<br /> `name_line_1`, `name_line_2`, `name_line_3` |
| data\[].config.fulfillment.card\_personalization.text.**name\_line\_1**<br />object<br /> Returned | Specifies the first line of personalized text that appears on the card.<br /><br />**Allowable Values:**<br /> `name_line_1.value`<br /> 21 char max; if `name_line_1_numeric_postfix` is `true`, 14 char max.<br /> Strings longer than the character limit are truncated. |
| data\[].config.fulfillment.card\_personalization.text.name\_line\_1.**value**<br />string<br /> Conditionally returned | Line of personalized text printed on the card.<br /><br />**Allowable Values:**<br /> 21 char max |
| data\[].config.fulfillment.card\_personalization.text.**name\_line\_2**<br />object<br /> Conditionally returned | Specifies the second line of personalized text that appears on the card.<br /><br />**Allowable Values:**<br /> `name_line_2.value` |
| data\[].config.fulfillment.card\_personalization.text.name\_line\_2.**value**<br />string<br /> Conditionally returned | Line of personalized text printed on the card.<br /><br />**Allowable Values:**<br /> 21 char max |
| data\[].config.fulfillment.card\_personalization.text.**name\_line\_3**<br />object<br /> Conditionally returned | Specifies the third line of personalized text that appears on the card.<br /><br />**Allowable Values:**<br /> `name_line_3.value` |
| data\[].config.fulfillment.card\_personalization.text.name\_line\_3.**value**<br />string<br /> Conditionally returned | Line of personalized text printed on the card.<br /><br />**Allowable Values:**<br /> 21 char max |
| data\[].config.fulfillment.**enable\_offline\_pin**<br />boolean<br /> Conditionally returned | Enables offline personal identification number (PIN) verification for Europay Mastercard and Visa (EMV, or "chip-and-PIN") card payments.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.fulfillment.**fulfillment\_provider**<br />string<br /> Conditionally returned | Specifies the fulfillment provider.<br />You can work with providers located in North America, Europe, South America, and the Asia-Pacific region. For more information, see <a href="/docs/developer-guides/managing-physical-cards/#_fulfillment_providers_by_location">Fulfillment providers by location</a>.<br />**NOTE:** Expedited processing is available for cards that are fulfilled by <a href="https://www.arroweye.com/" target="_blank" rel="noopener">Arroweye Solutions</a>, <a href="https://www.gi-de.com/" target="_blank" rel="noopener">G+D</a>, <a href="http://www.idemia.com" target="_blank" rel="noopener">IDEMIA</a>, and <a href="http://perfectplastic.com/" target="_blank" rel="noopener">Perfect Plastic Printing</a>. You can expedite an order's processing by using the `expedite` field of the <a href="/docs/core-api/cards/">card</a> or <a href="/docs/core-api/bulk-card-orders/">bulkissuance</a> object. Contact your Marqeta representative for information regarding the cost of expedited service.<br /><br />**Allowable Values:**<br /> `ABCORP`, `ALLPAY`, `ARROWEYE`, `CPI`, `EXCEET_DE`, `GD`, `GEMALTO`, `IDEMIA`, `IDEMIA_AU`, `IDEMIA_CZ`, `IDEMIA_DE`, `IDEMIA_FR`, `IDEMIA_FR_SC`, `IDEMIA_LA`, `IDEMIA_PL`, `IDEMIA_UK`, `NID`, `NITECREST`, `NITECREST_PL`, `NITECREST_UK_SC`, `OBERTHUR`, `OBERTHUR_SC`, `PERFECTPLASTIC`, `TAG`<br /><br />**Default value:**<br />`PERFECTPLASTIC` |
| data\[].config.fulfillment.**package\_id**<br />string<br /> Conditionally returned | Card fulfillment provider's package ID.<br /><br />**Allowable Values:**<br /> 1–50 chars |
| data\[].config.fulfillment.**pan\_length**<br />string<br /> Conditionally returned | Specifies the length of the primary account number (PAN).<br /><br />**Allowable Values:**<br /><br />**Default value:**<br />16 |
| data\[].config.fulfillment.**payment\_instrument**<br />string<br /> Conditionally returned | Specifies the physical form cards of this card product type will take.<br /><br />**Allowable Values:**<br /> `PHYSICAL_MSR`, `PHYSICAL_ICC`, `PHYSICAL_CONTACTLESS`, `PHYSICAL_COMBO`, `VIRTUAL_PAN`<br /><br />**Default value:**<br />`PHYSICAL_MSR` |
| data\[].config.fulfillment.**shipping**<br />object<br /> Conditionally returned | Specifies shipping details for the order.<br /><br />**Allowable Values:**<br /> `care_of_line`, `method`, `recipient_address`, `return_address` |
| data\[].config.fulfillment.shipping.**care\_of\_line**<br />string<br /> Conditionally returned | Adds the specified value as a care of (C/O) line to the mailing carrier.<br />**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.<br /><br />**Allowable Values:**<br /> 255 char max |
| data\[].config.fulfillment.shipping.**method**<br />string<br /> Conditionally returned | Specifies the shipping service.<br /><br />**Allowable Values:**<br /> `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`<br /> Shipping options vary by card provider. For details on the specific shipping companies and services offered by your card provider, contact your Marqeta representative. |
| data\[].config.fulfillment.shipping.**recipient\_address**<br />object<br /> Conditionally returned | Address to which the order will be shipped.<br />In order to generate cards, a valid shipping address must be provided by one of these:<br />- The card or bulk card order's `fulfillment.shipping.recipient_address` field<br />- The users' `address` fields<br />- The card product's `config.fulfillment.shipping.recipient_address` field<br />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.<br /><br />**Allowable Values:**<br /> Valid `recipient_address` object |
| data\[].config.fulfillment.shipping.recipient\_address.**address1**<br />string<br /> Conditionally returned | Number and street of the address.<br /><br />**Allowable Values:**<br /> 255 char max<br /> 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. |
| data\[].config.fulfillment.shipping.recipient\_address.**address2**<br />string<br /> Conditionally returned | Additional address information.<br /><br />**Allowable Values:**<br /> 255 char max<br /> 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. |
| data\[].config.fulfillment.shipping.recipient\_address.**city**<br />string<br /> Conditionally returned | City of the address.<br /><br />**Allowable Values:**<br /> 40 char max |
| data\[].config.fulfillment.shipping.recipient\_address.**country**<br />string<br /> Conditionally returned | Country of the address.<br /><br />**Allowable Values:**<br /> 40 char max<br /> English short name. For example, for the Kingdom of Spain, use the English short name "Spain".<br /> The ISO maintains the <a href="https://www.iso.org/obp/ui/#search/code/" target="_blank" rel="noopener">full list of country codes</a>. |
| data\[].config.fulfillment.shipping.recipient\_address.**first\_name**<br />string<br /> Conditionally returned | First name of the addressee.<br /><br />**Allowable Values:**<br /> 40 char max |
| data\[].config.fulfillment.shipping.recipient\_address.**last\_name**<br />string<br /> Conditionally returned | Last name of the addressee.<br /><br />**Allowable Values:**<br /> 40 char max |
| data\[].config.fulfillment.shipping.recipient\_address.**middle\_name**<br />string<br /> Conditionally returned | Middle name of the addressee.<br /><br />**Allowable Values:**<br /> 40 char max |
| data\[].config.fulfillment.shipping.recipient\_address.**phone**<br />string<br /> Conditionally returned | Telephone number of the addressee.<br /><br />**Allowable Values:**<br /> 20 char max |
| data\[].config.fulfillment.shipping.recipient\_address.**postal\_code**<br />string<br /> Conditionally returned | Postal code of the address.<br /><br />**Allowable Values:**<br /> 10 char max |
| data\[].config.fulfillment.shipping.recipient\_address.**state**<br />string<br /> Conditionally returned | State of the address.<br /><br />**Allowable Values:**<br /> 32 char max |
| data\[].config.fulfillment.shipping.recipient\_address.**zip**<br />string<br /> Conditionally returned | United States ZIP code of the address.<br /><br />**Allowable Values:**<br /> 10 char max |
| data\[].config.fulfillment.shipping.**return\_address**<br />object<br /> Conditionally returned | Address to which the order will be returned if shipping fails.<br /><br />**Allowable Values:**<br /> `address1`, `address2`, `city`, `country`, `first_name`, `last_name`, `middle_name`, `phone`, `postal_code`, `state`, `zip` |
| data\[].config.fulfillment.shipping.return\_address.**address1**<br />string<br /> Conditionally returned | Number and street of the address.<br /><br />**Allowable Values:**<br /> 255 char max<br /> 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. |
| data\[].config.fulfillment.shipping.return\_address.**address2**<br />string<br /> Conditionally returned | Additional address information.<br /><br />**Allowable Values:**<br /> 255 char max<br /> 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. |
| data\[].config.fulfillment.shipping.return\_address.**city**<br />string<br /> Conditionally returned | City of the address.<br /><br />**Allowable Values:**<br /> 40 char max |
| data\[].config.fulfillment.shipping.return\_address.**country**<br />string<br /> Conditionally returned | Country of the address.<br /><br />**Allowable Values:**<br /> 40 char max<br /> English short name. For example, for the Kingdom of Spain, use the English short name "Spain".<br /> The ISO maintains the <a href="https://www.iso.org/obp/ui/#search/code/" target="_blank" rel="noopener">full list of country codes</a>. |
| data\[].config.fulfillment.shipping.return\_address.**first\_name**<br />string<br /> Conditionally returned | First name of the addressee.<br /><br />**Allowable Values:**<br /> 40 char max |
| data\[].config.fulfillment.shipping.return\_address.**last\_name**<br />string<br /> Conditionally returned | Last name of the addressee.<br /><br />**Allowable Values:**<br /> 40 char max |
| data\[].config.fulfillment.shipping.return\_address.**middle\_name**<br />string<br /> Conditionally returned | Middle name of the addressee.<br /><br />**Allowable Values:**<br /> 40 char max |
| data\[].config.fulfillment.shipping.return\_address.**phone**<br />string<br /> Conditionally returned | Telephone number of the addressee.<br /><br />**Allowable Values:**<br /> 20 char max |
| data\[].config.fulfillment.shipping.return\_address.**postal\_code**<br />string<br /> Conditionally returned | Postal code of the address.<br /><br />**Allowable Values:**<br /> 10 char max |
| data\[].config.fulfillment.shipping.return\_address.**state**<br />string<br /> Conditionally returned | State of the address.<br /><br />**Allowable Values:**<br /> 32 char max |
| data\[].config.fulfillment.shipping.return\_address.**zip**<br />string<br /> Conditionally returned | United States ZIP code of the address.<br /><br />**Allowable Values:**<br /> 10 char max |
| data\[].config.fulfillment.**uppercase\_name\_lines**<br />boolean<br /> Conditionally returned | A value of `true` sets the text in the `fulfillment.card_personalization.text.name_line_1` and `name_line_2` fields to all uppercase letters. A value of `false` leaves the text in its original state.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`true` |
| data\[].config.**jit\_funding**<br />object<br /> Conditionally returned | Governs the behavior of JIT Funding.<br /><br />**Allowable Values:**<br /> `paymentcard_funding_source`, `program_funding_source`, `programgateway_funding_source` |
| data\[].config.jit\_funding.**paymentcard\_funding\_source**<br />object<br /> Conditionally returned | Enables and configures a payment card funding source.<br /><br />**Allowable Values:**<br /> Valid `paymentcard_funding_source` object |
| data\[].config.jit\_funding.paymentcard\_funding\_source.**enabled**<br />boolean<br /> Conditionally returned | Specifies whether JIT Funding is enabled or disabled for the payment card funding source. A value of `true` indicates that the payment card funding source is enabled and will be debited when swipes occur.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.jit\_funding.paymentcard\_funding\_source.**refunds\_destination**<br />string<br /> Conditionally returned | Specifies the return destination for refunds in the case of a transaction reversal.<br /><br />**Allowable Values:**<br /> `GATEWAY`, `GPA`, `WATERFALL` |
| data\[].config.jit\_funding.**program\_funding\_source**<br />object<br /> Conditionally returned | Enables and configures a program funding source.<br /><br />**Allowable Values:**<br /> Valid `program_funding_source` object |
| data\[].config.jit\_funding.program\_funding\_source.**enabled**<br />boolean<br /> Conditionally returned | Specifies whether JIT Funding is enabled or disabled for the program funding source. A value of `true` indicates that the program funding source is enabled and will be debited when swipes occur.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.jit\_funding.program\_funding\_source.**funding\_source\_token**<br />string<br /> Conditionally returned | Unique identifier of the already existing funding source. Required if JIT Funding is enabled.<br /><br />**Allowable Values:**<br /> 36 char max |
| data\[].config.jit\_funding.program\_funding\_source.**refunds\_destination**<br />string<br /> Conditionally returned | Specifies the return destination for refunds in the case of a transaction reversal. `PROGRAM_FUNDING_SOURCE` returns funds to the program funding source. `GPA` returns the funds to the user's GPA.<br /><br />**Allowable Values:**<br /> `PROGRAM_FUNDING_SOURCE`, `GPA`, `WATERFALL` |
| data\[].config.jit\_funding.**programgateway\_funding\_source**<br />object<br /> Conditionally returned | Enables and configures a program gateway funding source.<br /><br />**Allowable Values:**<br /> Valid `programgateway_funding_source` object |
| data\[].config.jit\_funding.programgateway\_funding\_source.**always\_fund**<br />boolean<br /> Conditionally returned | If set to `true`, this card product is always funded from this program gateway funding source.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.jit\_funding.programgateway\_funding\_source.**enabled**<br />boolean<br /> Conditionally returned | Specifies whether JIT Funding is enabled or disabled for the program gateway funding source. A value of `true` indicates that the program gateway funding source is enabled and will be debited when swipes occur.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.jit\_funding.programgateway\_funding\_source.**funding\_source\_token**<br />string<br /> Conditionally returned | Unique identifier of the already existing funding source. Required if JIT Funding is enabled.<br /><br />**Allowable Values:**<br /> 36 char max |
| data\[].config.jit\_funding.programgateway\_funding\_source.**refunds\_destination**<br />string<br /> Conditionally returned | Specifies the return destination for refunds in the case of a transaction reversal. In most cases, you should set the value to `GATEWAY`, which returns funds to the program gateway funding source. Setting to `GPA` returns the funds to the user's GPA, which creates a positive account balance and introduces the potential of a transaction being authorized without a JIT Funding request being sent to the gateway.<br /><br />**Allowable Values:**<br /> `GATEWAY`, `GPA`, `WATERFALL` |
| data\[].config.**poi**<br />object<br /> Conditionally returned | Governs the point of interaction.<br /><br />**Allowable Values:**<br /> `atm`, `ecommerce`, `other` |
| data\[].config.poi.**atm**<br />boolean<br /> Conditionally returned | If set to `true`, cards can be used for withdrawing cash at an ATM and for receiving cash back at a point of sale (POS).<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.poi.**ecommerce**<br />boolean<br /> Conditionally returned | If set to `true`, cards can be used for online purchases.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.poi.**other**<br />object<br /> Conditionally returned | Allows for configuration of points of interaction other than ecommerce or ATMs, such as points of sale (POS).<br /><br />**Allowable Values:**<br /> `allow`, `card_presence_required`, `cardholder_presence_required`, `use_random_pin` |
| data\[].config.poi.other.**allow**<br />boolean<br /> Conditionally returned | If set to `true`, card transactions at points of interaction other than e-commerce or ATMs are allowed. This group includes points of sale (POS).<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`true` |
| data\[].config.poi.other.**card\_presence\_required**<br />boolean<br /> Conditionally returned | If set to `true`, cards of this card product type are required to be present during the transaction, such as in IVR scenarios.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.poi.other.**cardholder\_presence\_required**<br />boolean<br /> Conditionally returned | If set to `true`, the cardholder is required to be present during the transaction, such as in a restaurant where the card is present but the cardholder might not be present when the card is swiped.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.poi.other.**use\_random\_pin**<br />boolean<br /> Optional | If set to `true`, cards of this card product type will be assigned a random PIN.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.**selective\_auth**<br />object<br /> Conditionally returned | Contains information about authorization decisions.<br /><br />**Allowable Values:**<br /> `dmd_location_sensitivity`, `enable_regex_search_chain`, `sa_mode` |
| data\[].config.selective\_auth.**dmd\_location\_sensitivity**<br />integer<br /> Conditionally returned | Determines what type of merchant information is required for a match (authorization). Not relevant if `enable_regex_search_chain = false`.<br />- **0** – Requires exact match on card acceptor name and postal code to existing entry in Marqeta Merchant database (most restrictive).<br />- **1** – Partial match on card acceptor name (least restrictive).<br />- **2** – Partial match on card acceptor name; exact match on card acceptor city.<br />- **3** – Partial match on card acceptor name; exact match on card acceptor postal code.<br />- **4** – Partial match on card acceptor name; exact match on street address 1 and postal code.<br /><br />**Allowable Values:**<br /> `0`, `1`, `2`, `3`, `4`<br /><br />**Default value:**<br />0 |
| data\[].config.selective\_auth.**enable\_regex\_search\_chain**<br />boolean<br /> Conditionally returned | Set to `true` to perform regular expression checking on the description received in the authorization.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.selective\_auth.**sa\_mode**<br />integer<br /> Conditionally returned | Specifies the selective authorization mode.<br />- **0** — Inactive<br />- **1** — Active (attempts to authorize a merchant that does not have a recognized MID by matching other pieces of information)<br />- **2** — Logging and notification (checks the transaction and logs results, but does not authorize)<br />Selective authorization applies to transactions that are limited to specific merchants. Matching requirements for authorization are set by the `dmd_location_sensitivity` field.<br /><br />**Allowable Values:**<br /> `0`, `1`, `2`<br /><br />**Default value:**<br />0 |
| data\[].config.**special**<br />object<br /> Conditionally returned | Contains information about merchant onboarding.<br /><br />**Allowable Values:**<br /> `merchant_on_boarding` |
| data\[].config.special.**merchant\_on\_boarding**<br />boolean<br /> Conditionally returned | If set to `true`, cards of this card product type can be used for merchant onboarding.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.**transaction\_controls**<br />object<br /> Conditionally returned | Controls transactional characteristics of card usage.<br /><br />**Allowable Values:**<br /> `accepted_countries_token`, `address_verification`, `allow_chip_fallback`, `allow_first_pin_set_via_financial_transaction`, `allow_gpa_auth`, `allow_mcc_group_authorization_controls`, `allow_network_load`, `allow_network_load_card_activation`, `allow_quasi_cash`, `always_require_icc`, `always_require_pin`, `auth_control_default_behavior`, `av_accepted_countries_token`, `enable_partial_auth_approval`, `ignore_card_suspended_state`, `notification_language`, `quasi_cash_exempt_merchant_group_token`, `quasi_cash_exempt_mids`, `require_card_not_present_card_security_code`, `strong_customer_authentication_limits` |
| data\[].config.transaction\_controls.**accepted\_countries\_token**<br />string<br /> Conditionally returned | Set to `accept_us_only` to allow transactions only within the US.<br />Set to `decline_ofac_countries` to allow international transactions except with countries that the Financial Action Task Force (FATF) and Office of Foreign Assets Control (OFAC) have identified as high risk.<br />Users with the Admin role can create and update additional lists of accepted countries for transactions at the `/acceptedcountries` endpoint. See <a href="/docs/core-api/accepted-countries/">Accepted Countries</a>.<br /><br />**Allowable Values:**<br /> `accept_us_only`, `decline_ofac_countries`, additional Admin-defined tokens<br /><br />**Default value:**<br />`accept_us_only` |
| data\[].config.transaction\_controls.**address\_verification**<br />object<br /> Conditionally returned | Contains configuration options for AVS.<br /><br />**Allowable Values:**<br /> Valid `address_verification` object |
| data\[].config.transaction\_controls.address\_verification.**auth\_messages**<br />object<br /> Conditionally returned | Contains verification options for authorization messages.<br />These messages pertain to actual purchases and are for amounts greater than \$0.<br /><br />**Allowable Values:**<br /> One or more verification options |
| data\[].config.transaction\_controls.address\_verification.**av\_messages**<br />object<br /> Conditionally returned | Contains verification options for account verification messages.<br />These are \$0 messages typically used to store cards on file at a merchant.<br /><br />**Allowable Values:**<br /> One or more verification options |
| data\[].config.transaction\_controls.**afd\_hold\_increase\_override**<br />integer<br /> Conditionally returned | Overrides AFD (MCC 5542) `hold_increase.value` at the card product level with the specified value. Expressed in positive whole numbers and major units of the cardholder billing currency. If this field is not configured, the program-wide MCC-group `hold_increase.value` applies.<br /><br />**Allowable Values:**<br /> Any whole number |
| data\[].config.transaction\_controls.**afd\_minimum\_hold\_amount**<br />string<br /> Conditionally returned | Sets the automated fuel dispenser (AFD) pre-authorization threshold, in the card product's currency, that triggers a hold increase. This field works together with `afd_hold_increase_override`: `afd_minimum_hold_amount` is the threshold, and `afd_hold_increase_override` is the amount Marqeta increases the hold to. Marqeta increases the authorization hold when the pre-authorization amount is at or below this threshold, or, for international transactions, when the local transaction amount is at or below this threshold. This field applies to transactions with merchant category code (MCC) 5542.<br />If Marqeta doesn't return the `afd_minimum_hold_amount` field or the value is `NONE`, the following applies:<br />1. The program-level default applies, if your Marqeta representative configured it. Contact your Marqeta representative to learn what it's set to.<br />2. If there is no program-level default, Marqeta increases the hold only when the pre-authorization amount equals exactly \$0 or \$1.<br /><br />**Allowable Values:**<br /> An amount greater than 0.00, up to 10.00, in the card product's currency; `NONE` |
| data\[].config.transaction\_controls.**afd\_preauth\_expiration\_hours**<br />integer<br /> Conditionally returned | Overrides the AFD (MCC 5542) pre-authorization hold expiration at the card product level with the specified value. Expressed in whole hours. If set to a value greater than `0`, this value takes priority over the program-level default, which is the network-provided expiration value, and the MCC-group configuration. Set to `0` to remove the override and fall through to the next value in the resolution order.<br /><br />**Allowable Values:**<br /> Any whole number of hours; `0` to remove the override |
| data\[].config.transaction\_controls.**allow\_chip\_fallback**<br />boolean<br /> Conditionally returned | Indicates whether to allow transactions where a Europay Mastercard and Visa (EMV) chip-enabled card was processed using the magstripe as fallback.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`true` |
| data\[].config.transaction\_controls.**allow\_first\_pin\_set\_via\_financial\_transaction**<br />boolean<br /> Conditionally returned | **WARNING:** This field is deprecated and will be unsupported in a future release.<br />Allows cardholders to define a personal identification number (PIN) as they complete their first PIN-debit transaction.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.transaction\_controls.**allow\_gpa\_auth**<br />boolean<br /> Conditionally returned | If set to `true`, transactions can be authorized using GPA funds.<br />**NOTE:** For most programs, this field should be set to `true`.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`true` |
| data\[].config.transaction\_controls.**allow\_mcc\_group\_authorization\_controls**<br />boolean<br /> Conditionally returned | The <a href="/docs/core-api/mcc-groups/">MCC group</a>`authorization_controls` object allows you to automatically increase authorization holds and to specify authorization expiration times based on merchant type. By default, these settings apply to all cards in your program.<br />However, you can make cards that are associated with a particular card product exempt from increasing authorization holds by setting the `allow_mcc_group_authorization_controls` field to `false`. Doing so does not impact authorization expiration times.<br />**NOTE:**<a href="/docs/developer-guides/money-movement-overview/#_automated_fuel_dispenser_afd_transactions">Automated fuel dispenser (AFD)</a> transactions (MCC 5542) ignore this field, because Marqeta will increase authorization holds for AFDs if the card product has been configured to do so.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`true` |
| data\[].config.transaction\_controls.**allow\_network\_load**<br />boolean<br /> Conditionally returned | Indicates whether card network loads are allowed. The associated card's state must be `ACTIVE` or the load will be rejected.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.transaction\_controls.**allow\_network\_load\_card\_activation**<br />boolean<br /> Conditionally returned | Indicates whether card network loads are allowed. Sets the associated card's state to `ACTIVE` if its current state is `INACTIVE`.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.transaction\_controls.**allow\_quasi\_cash**<br />boolean<br /> Conditionally returned | Indicates whether quasi-cash transactions are allowed. In a quasi-cash transaction, the cardholder purchases an item that can be directly converted to cash, such as traveler's checks, money orders, casino chips, or lottery tickets.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.transaction\_controls.**always\_require\_icc**<br />boolean<br /> Conditionally returned | If set to `true`, cards of this card product type require an Integrated Circuit Card.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.transaction\_controls.**always\_require\_pin**<br />boolean<br /> Conditionally returned | If set to `true`, cards of this card product type require a personal identification number (PIN).<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.transaction\_controls.**auth\_control\_default\_behavior**<br />string<br /> Conditionally returned | Card-product-level override of the program-level authorization control default behavior.<br />Set to `ALLOW` for blocklist semantics, where a matching authorization control declines the transaction and every other transaction is approved.<br />Set to `DENY` for allowlist semantics, where only a matching authorization control approves the transaction and every other transaction is declined.<br />If you leave this field unset, the program-level default applies.<br />The program-level default isn't independently configurable through the API.<br />Contact your Marqeta representative to learn what your program-level default is set to.<br /><br />**Allowable Values:**<br /> `ALLOW`, `DENY` |
| data\[].config.transaction\_controls.**av\_accepted\_countries\_token**<br />string<br /> Conditionally returned | Determines the list of countries in which \$0 account verification (AV) transactions are allowed. To receive `av_accepted_countries_token` in the response, you must configure it. By default, this field is not set and `accepted_countries_token` determines the allowed list of countries for AV transactions.<br />`accept_us_only` allows AV transactions only from the US.<br />`decline_ofac_countries` allows AV transactions from any country except those the Financial Action Task Force (FATF) and Office of Foreign Assets Control (OFAC) have identified as high risk.<br />`DISABLED` means `accepted_countries_token` determines the allowed list of countries for AV transactions instead.<br /><br />**Allowable Values:**<br /> `accept_us_only`, `decline_ofac_countries`, `DISABLED`, additional Admin-defined tokens |
| data\[].config.transaction\_controls.**enable\_partial\_auth\_approval**<br />boolean<br /> Conditionally returned | Set to `true` to enable partial authorizations.<br />When this setting is `false` and the requested authorization amount exceeds available funds, the transaction is declined. When this setting is `true` and the requested authorization amount exceeds available funds, the transaction is authorized for the amount of available funds.<br />**Note:** Automated fuel dispenser (AFD) transactions (MCC 5542) ignore this field, as Marqeta will always partially approve AFD pre-authorizations if the transaction payload field `partial_approval_capable` is enabled.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`true` |
| data\[].config.transaction\_controls.**ignore\_card\_suspended\_state**<br />boolean<br /> Conditionally returned | Allows transactions to be approved even if the card's `state = SUSPENDED`. When this field is set to `true`, the card behaves as if its `state = ACTIVE`.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.transaction\_controls.**notification\_language**<br />string<br /> Conditionally returned | Specifies the language for 3D Secure and digital wallet token notifications sent to cardholders under this card program.<br />You can send notifications to your cardholders in the following languages:<br />- **ces** – Czech<br />- **deu** – German<br />- **eng** – English<br />- **fra** – French<br />- **ell** – Greek<br />- **ita** – Italian<br />- **nld** – Dutch<br />- **pol** – Polish<br />- **por** – Portuguese<br />- **ron** – Romanian<br />- **spa** – Spanish<br />- **swe** – Swedish<br />By default, notifications are sent in English.<br />To specify the language for OTP notifications at the user level, see <a href="/docs/core-api/users/">Users</a>. Languages set at the user level take precedence over the language set at the card product level.<br />If you leave this field blank, cardholders receive notifications in English.<br /><br />**Allowable Values:**<br /> `ces`, `deu`, `eng`, `fra`, `ell`, `ita`, `nld`, `pol`, `por`, `ron`, `spa`, `swe` |
| data\[].config.transaction\_controls.**quasi\_cash\_exempt\_merchant\_group\_token**<br />string<br /> Conditionally returned | The token of the merchant group that you want to exempt from quasi-cash transaction authorization control, allowing your cardholders to conduct quasi-cash transactions. In a quasi-cash transaction, the cardholder purchases an item that can be directly converted to cash, such as traveler's checks, money orders, casino chips, or lottery tickets.<br />You can specify a merchant group token in addition to whatever merchant identifiers you listed in the `quasi_cash_exempt_mids` field, if any. For more information, see <a href="/docs/core-api/merchant-groups/">Merchant Groups</a>.<br /><br />**Allowable Values:**<br /> 1–36 chars<br /> Valid merchant group token. |
| data\[].config.transaction\_controls.**quasi\_cash\_exempt\_mids**<br />string<br /> Conditionally returned | Comma-separated list of merchant identifiers that you want to exempt from quasi-cash transaction authorization control, allowing your cardholders to conduct quasi-cash transactions. In a quasi-cash transaction, the cardholder purchases an item that can be directly converted to cash, such as traveler's checks, money orders, casino chips, or lottery tickets.<br /><br />**Allowable Values:**<br /> 255 char max<br /> For example: `12345678901,23456789012,34567890123,45678901234` |
| data\[].config.transaction\_controls.**require\_card\_not\_present\_card\_security\_code**<br />boolean<br /> Conditionally returned | A value of `true` indicates that if `card_presence_required` is `true`, the card's security code is required.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.transaction\_controls.**strong\_customer\_authentication\_limits**<br />object<br /> Conditionally returned | Contains information about Strong Customer Authentication (SCA) behavior for contactless point-of-sale (POS) and low-value payment (LVP) e-commerce transactions.<br /><br />**Allowable Values:**<br /> `sca_contactless_cumulative_amount_limit`, `sca_contactless_transaction_limit`, `sca_contactless_transactions_count_limit`, `sca_contactless_transactions_currency`, `sca_lvp_cumulative_amount_limit`, `sca_lvp_transaction_limit`, `sca_lvp_transactions_count_limit`, `sca_tra_exemption_amount_limit` |
| data\[].config.transaction\_controls.strong\_customer\_authentication\_limits.**cavv\_authentication\_amount\_incremental\_percentage**<br />string<br /> Conditionally returned | If you have enabled CAVV authentication amount validation, the value of this field specifies the maximum allowable variance between the authorization amount and the 3D Secure authentication amount. Expressed as a percentage.<br /><br />**Allowable Values:**<br /> 255 char max<br /><br />**Default value:**<br />0 |
| data\[].config.transaction\_controls.strong\_customer\_authentication\_limits.**enable\_cavv\_authentication\_amount\_validation**<br />boolean<br /> Conditionally returned | If set to `true`, Marqeta validates the amount in the authorization transaction against the amount in the 3D Secure authentication attempt. If the authorization amount is greater than the 3D Secure authentication amount, Marqeta rejects the transaction. You can specify an allowable variance for the 3D Secure authentication amount in the `cavv_authentication_amount_incremental_percentage` field.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.transaction\_controls.strong\_customer\_authentication\_limits.**enable\_issuer\_tra\_exemption**<br />boolean<br /> Conditionally returned | If set to `true`, Marqeta does not increment the low-value payment (LVP) counter for frictionless 3D Secure transactions.<br />This field is enabled in your card product configuration. Contact your Marqeta representative to configure this field for your program.<br /><br />**Allowable Values:**<br /> `true`, `false`<br /><br />**Default value:**<br />`false` |
| data\[].config.transaction\_controls.strong\_customer\_authentication\_limits.**sca\_contactless\_cumulative\_amount\_limit**<br />decimal<br /> Conditionally returned | Specifies the cumulative limit of transactions the cardholder can perform before receiving an SCA challenge.<br />A value of `0` in this field means that the cumulative amount spent in contactless POS transactions performed by the cardholder does not impact the decision of whether or not an SCA challenge is served.<br /><br />**Allowable Values:**<br /> decimal<br /><br />**Format:**<br />0.00<br />There is no default value for this field. |
| data\[].config.transaction\_controls.strong\_customer\_authentication\_limits.**sca\_contactless\_transaction\_limit**<br />decimal<br /> Conditionally returned | Specifies the maximum allowable amount for a single contactless point-of-sale (POS) transaction, above which the cardholder receives a strong customer authentication (SCA) challenge.<br />A value of `0` in this field means that the amount of any single contactless POS transaction performed by the cardholder does not impact the decision of whether or not an SCA challenge is served.<br /><br />**Allowable Values:**<br /> decimal<br /><br />**Format:**<br />0.00<br />There is no default value for this field. |
| data\[].config.transaction\_controls.strong\_customer\_authentication\_limits.**sca\_contactless\_transactions\_count\_limit**<br />integer<br /> Conditionally returned | Specifies the number of contactless POS transactions the cardholder can perform before receiving an SCA challenge.<br />A value of `0` in this field means that the number of contactless POS transactions performed by the cardholder does not impact the decision of whether or not an SCA challenge is served.<br /><br />**Allowable Values:**<br /> Any integer, such as `5`.<br /> There is no default value for this field. |
| data\[].config.transaction\_controls.strong\_customer\_authentication\_limits.**sca\_contactless\_transactions\_currency**<br />string<br /> Conditionally returned | Specifies the currency type for contactless POS transactions.<br />This field is required if either the `sca_contactless_transaction_limit` field or the `sca_contactless_cumulative_amount_limit` field in this object contains a value, even if that value is `0`.<br /><br />**Allowable Values:**<br /> Valid three-digit ISO 4217 currency type, such as `EUR`.<br /> There is no default value for this field. |
| data\[].config.transaction\_controls.strong\_customer\_authentication\_limits.**sca\_lvp\_cumulative\_amount\_limit**<br />decimal<br /> Conditionally returned | Specifies the cumulative limit of low-value payment (LVP) e-commerce transactions the cardholder can perform before receiving an SCA challenge.<br />For example, if you set the value of this field to `100.00`, your cardholder can perform two transactions for `30.00` and two transactions for `20.00` before receiving an SCA challenge.<br />If you leave this field blank, the cumulative amount spent in LVP e-commerce transactions performed by the cardholder does not impact the decision of whether or not an SCA challenge is served.<br /><br />**Allowable Values:**<br /> decimal<br /><br />**Format:**<br />0.00<br />There is no default value for this field. |
| data\[].config.transaction\_controls.strong\_customer\_authentication\_limits.**sca\_lvp\_transaction\_limit**<br />decimal<br /> Conditionally returned | Specifies the maximum allowable amount for a single low-value payment (LVP) e-commerce transaction, above which the cardholder receives a strong customer authentication (SCA) challenge.<br />If you leave this field blank, the amount of any single LVP e-commerce transaction performed by the cardholder does not impact the decision of whether or not an SCA challenge is served.<br /><br />**Allowable Values:**<br /> decimal<br /><br />**Format:**<br />0.00<br />There is no default value for this field. |
| data\[].config.transaction\_controls.strong\_customer\_authentication\_limits.**sca\_lvp\_transactions\_count\_limit**<br />integer<br /> Conditionally returned | Specifies the number of LVP e-commerce transactions the cardholder can perform before receiving an SCA challenge.<br />If you leave this field blank, the total number of LVP e-commerce transactions performed by the cardholder does not impact the decision of whether or not an SCA challenge is served.<br /><br />**Allowable Values:**<br /> An integer, such as `5`.<br /> There is no default value for this field. |
| data\[].config.transaction\_controls.strong\_customer\_authentication\_limits.**sca\_lvp\_transactions\_currency**<br />string<br /> Conditionally returned | Specifies the currency type for LVP e-commerce transaction limits.<br />This field is required if any one of the `sca_lvp_transaction_limit`, `sca_lvp_cumulative_amount_limit`, or `sca_lvp_transactions_count_limit` fields in this object contains a value, even if that value is `0`.<br /><br />**Allowable Values:**<br /> Valid three-digit ISO 4217 currency type, such as `EUR`.<br /> There is no default value for this field. |
| data\[].config.transaction\_controls.strong\_customer\_authentication\_limits.**sca\_tra\_exemption\_amount\_limit**<br />decimal<br /> Conditionally returned | Specifies the maximum allowable amount for a single low-value payment (LVP) e-commerce transaction with transaction risk analysis (TRA) exemption sent by the merchant or acquirer. If the transaction amount exceeds the specified limit, then the transaction is either approved or it receives a strong customer authentication (SCA) challenge based on `sca_lvp_transaction_limit` and `sca_lvp_transactions_currency`.<br /><br />**Allowable Values:**<br /> decimal<br /><br />**Format:**<br />0.00<br />**Default value:**<br />`0.00` |
| data\[].**created\_time**<br />datetime<br /> Returned | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /> datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ |
| data\[].**end\_date**<br />date<br /> Conditionally returned | End date of the range over which the card product can be active.<br />This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /> Format: yyyy-mm-DD |
| data\[].**last\_modified\_time**<br />datetime<br /> Returned | Date and time when the resource was last updated, in UTC.<br /><br />**Allowable Values:**<br /> datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ |
| data\[].**name**<br />string<br /> Returned | Name of the card product.<br /><br />**Allowable Values:**<br /> 1–40 chars |
| data\[].**start\_date**<br />date<br /> Returned | Date when the card product becomes active.<br /><br />**Allowable Values:**<br /> Format: yyyy-mm-DD |
| data\[].**token**<br />string<br /> Conditionally returned | Unique identifier of the card product.<br />If you did not include a token in your request, the system returns an automatically generated token in the response.<br /><br />**Allowable Values:**<br /> 1–36 chars |
| end\_index<br />integer<br /> Conditionally returned | Sort order index of the last resource in the returned array.<br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /> Any integer |
| is\_more<br />boolean<br /> Conditionally returned | A value of `true` indicates that more unreturned resources exist. A value of `false` indicates that no more unreturned resources exist.<br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /> `true`, `false` |
| start\_index<br />integer<br /> Conditionally returned | Sort order index of the first resource in the returned array.<br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /> Any integer |

<h2 id="_sample_response_body_2">
  Sample response body
</h2>

```json JSON expandable lines wrap theme={null}
{
  "count": 1,
  "start_index": 0,
  "end_index": 0,
  "is_more": true,
  "data[]": {
    "token": "my_cardproduct_01",
    "name": "My Card Product 01",
    "active": true,
    "config": {
      "poi": {
        "other": {
          "allow": "true,",
          "card_presence_required": "false,",
          "cardholder_presence_required": false
        },
        "ecommerce": false,
        "atm": false
      },
      "transaction_controls": {
        "accepted_countries_token": "accept_us_only",
        "always_require_pin": false,
        "always_require_icc": false,
        "allow_gpa_auth": true,
        "require_card_not_present_card_security_code": false,
        "allow_mcc_group_authorization_controls": true,
        "ignore_card_suspended_state": false,
        "allow_network_load": false,
        "allow_network_load_card_activation": false,
        "allow_quasi_cash": false,
        "enable_partial_auth_approval": true,
        "notification_language": "fra",
        "address_verification": {
          "av_messages": {
            "validate": true,
            "decline_on_address_number_mismatch": false,
            "decline_on_postal_code_mismatch": true
          },
          "auth_messages": {
            "validate": true,
            "decline_on_address_number_mismatch": false,
            "decline_on_postal_code_mismatch": false
          }
        }
      },
      "fulfillment": {
        "shipping": {
          "method": "OVERNIGHT",
          "return_address": {
            "first_name": "Saki",
            "middle_name": "R",
            "last_name": "Dogger",
            "address1": "123 Henry St",
            "address2": "Suite 101",
            "city": "Porterville",
            "state": "CA",
            "postal_code": "93257",
            "country": "USA",
            "phone": "8315555555"
          },
          "recipient_address": {
            "first_name": "Jane",
            "last_name": "Doe",
            "address1": "1234 Grove Street",
            "city": "Berkeley",
            "state": "CA",
            "postal_code": 94702,
            "country": "USA",
            "phone": "5105551212"
          }
        },
        "card_personalization": {
          "text": {
            "name_line_1": null,
            "value": "Saki Dogger",
            "name_line_2": {
              "value": "Aegis Fleet Services"
            }
          },
          "carrier": {
            "name": "my_carrier_logo.png",
            "message_line": "my message"
          },
          "images": {
            "card": {
              "name": "my_card_logo.png",
              "thermal_color": "Black"
            }
          },
          "signature": {
            "name": "my_signature.png"
          },
          "carrier_return_window": {
            "name": "my_return_address_image.png"
          }
        }
      },
      "payment_instrument": "PHYSICAL_MSR",
      "package_id": "0",
      "all_zero_card_security_code": false,
      "bin_prefix": "111111",
      "bin_issue_country": "USA",
      "bulk_ship": false,
      "pan_length": "16",
      "fulfillment_provider": "PERFECTPLASTIC",
      "allow_card_creation": true,
      "uppercase_name_lines": true
    },
    "selective_auth": {
      "sa_mode": 1,
      "enable_regex_search_chain": false,
      "dmd_location_sensitivity": 0
    },
    "card_life_cycle": {
      "activate_upon_issue": true,
      "expiration_offset": {
        "unit": "YEARS",
        "value": 10,
        "min_offset": {
          "unit": "YEARS",
          "value": 4
        }
      },
      "card_service_code": 101,
      "update_expiration_upon_activation": false
    },
    "clearing_and_settlement": {
      "overdraft_destination": "GPA"
    },
    "jit_funding": {
      "paymentcard_funding_source": {
        "enabled": true,
        "refunds_destination": ""
      },
      "programgateway_funding_source": {
        "enabled": false,
        "funding_source_token": "",
        "refunds_destination": "GATEWAY"
      },
      "program_funding_source": {
        "enabled": false,
        "funding_source_token": "",
        "refunds_destination": "PROGRAM_FUNDING_SOURCE"
      }
    },
    "digital_wallet_tokenization": {
      "provisioning_controls": {
        "manual_entry": {
          "enabled": false,
          "address_verification": {
            "validate": true
          }
        },
        "wallet_provider_card_on_file": {
          "enabled": false,
          "address_verification": {
            "validate": true
          }
        },
        "in_app_provisioning": {
          "enabled": false,
          "address_verification": {
            "validate": true
          }
        },
        "dwt_use_card_status_during_auth": false
      }
    },
    "start_date": "2022-04-27",
    "created_time": "2022-04-27T19:25:55Z",
    "last_modified_time": "2022-04-27T21:29:12Z"
  }
}
```


## Related topics

- [Card Products Overview](/docs/core-api/card-products.md)
- [List credit products](/docs/core-api/credit-products/list-credit-products.md)
- [List credit product policies](/docs/core-api/credit-policies/product-policies/list-product.md)
- [Card Products in Europe](/docs/developer-guides/mq-eu-card-products.md)
- [Credit Products in the Marqeta Dashboard](/docs/developer-guides/credit-products-dashboard.md)