> ## 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 bulk card orders > Use this endpoint to list existing bulk card orders. GET/bulkissuances Use this endpoint to list existing bulk card orders. This endpoint supports [pagination and sorting](https://www.marqeta.com/docs/core-api/sorting-and-pagination.md). ## URL query parameters | Fields | Description | | - | - | | count integer Optional | Number of bulk card orders to retrieve. **Allowable Values:** 1-10 **Default value:** 5 | | start\_index integer Optional | Sort order index of the first resource in the returned array. **Allowable Values:** Any integer **Default value:** 0 (The first bulk card order resource in your system) | | sort\_by string Optional | Field on which to sort. Use any field in the resource model, or one of the system fields `lastModifiedTime` or `createdTime`. Prefix the field name with a hyphen (`-`) to sort in descending order. Omit the hyphen to sort in ascending order. **Allowable Values:** `createdTime`, `lastModifiedTime`, or any field in the resource model **Default value:** `-createdTime` | ## Response body | Fields | Description | | - | - | | count integer Conditionally returned | Number of resources retrieved. This field is returned if there are resources in your returned array. **Allowable Values:** 1-10 | | data array of objects Conditionally returned | Array of bulk issuance objects. Objects are returned as appropriate to your query. **Allowable Values:** Valid array of one or more bulk issuance objects | | data\[].**card\_allocation** integer Returned | Number of cards in the order. **Allowable Values:** 50000 max | | data\[].**card\_fulfillment\_time** datetime Conditionally returned | Date and time when the bulk card order was fulfilled, in UTC. This field is included if your bulk card order has been processed. **Allowable Values:** Format: yyyy-MM-ddThh:mm:ssZ | | data\[].**card\_product\_token** string Returned | Specifies the card product from which the cards are created. **Allowable Values:** 1–36 chars | | data\[].**cards\_processed** integer Conditionally returned | Number of cards processed in the bulk card order. This field is returned if it exists in the resource. **Allowable Values:** Any positive integer | | data\[].**created\_time** datetime Conditionally returned | Date and time when the resource was created, in UTC. This field is returned if it exists in the resource. **Allowable Values:** Format: yyyy-MM-ddThh:mm:ssZ | | data\[].**expedite** boolean Conditionally returned | Indicates if expedited processing of this bulk card order was requested. This field is returned if it exists in the resource. **Allowable Values:** `true`, `false` | | data\[].**expiration\_offset** object Conditionally returned | Specifies the length of time after the date of issue for which the cards are valid. **Allowable Values:** `unit`, `value` | | data\[].expiration\_offset.**unit** string Conditionally returned | Specifies the units for the `value` field in this object. **Allowable Values:** `YEARS`, `MONTHS`, `DAYS`, `HOURS`, `MINUTES`, `SECONDS` **Default value:** `YEARS` | | data\[].expiration\_offset.**value** integer Conditionally returned | Specifies the number of time units (as defined by the `unit` field in this object) for which the cards are valid. In other words, cards expire `value` x `unit` after the date of issue. This number is rounded as follows: - **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. - **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. - **DAYS** – Rounds up to the last second of the day of expiration. - **HOURS**, **MINUTES**, **SECONDS** – No rounding. **Allowable Values:** Any positive integer **Default value:** 4 | | data\[].**fulfillment** object Returned | Specifies certain physical characteristics of a card, as well as bulk shipment information. This object is returned if it exists in the resource. **Allowable Values:** `card_personalization`, `shipping` | | data\[].fulfillment.**card\_personalization** object Returned | Specifies personalized attributes to be added to the card. **Allowable Values:** `carrier`, `images`, `perso_type`, `text` | | data\[].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` | | data\[].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. | | data\[].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. | | data\[].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. | | data\[].fulfillment.card\_personalization.carrier.**message\_line** string Conditionally returned | Specifies a custom message that appears on the card carrier. **Allowable Values:** 60 char max | | data\[].fulfillment.card\_personalization.carrier.**template\_id** string Conditionally returned | Specifies the card carrier template to use. **Allowable Values:** Card carrier template ID | | data\[].fulfillment.card\_personalization.**images** object Conditionally returned | Specifies personalized images that appear on the card. **Allowable Values:** `card`, `carrier`, `carrier_return_window`, `signature` | | data\[].fulfillment.card\_personalization.images.**card** object Conditionally returned | Specifies personalized images that appear on the card. **Allowable Values:** `name`, `thermal_color` | | data\[].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. | | data\[].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. | | data\[].fulfillment.card\_personalization.images.**carrier** object Conditionally returned | Specifies personalized images that appear on the card carrier. **Allowable Values:** `message_1`, `name` | | data\[].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 | | data\[].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. | | data\[].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` | | data\[].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. | | data\[].fulfillment.card\_personalization.images.**signature** object Conditionally returned | Specifies a PNG image of the cardholder's signature. **Allowable Values:** `name` | | data\[].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. | | data\[].fulfillment.card\_personalization.**perso\_type** string Conditionally returned | Specifies the type of card personalization. **Allowable Values:** `EMBOSS`, `LASER`, `FLAT` | | data\[].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` | | data\[].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. | | data\[].fulfillment.card\_personalization.text.name\_line\_1.**value** string Conditionally returned | Line of personalized text printed on the card. **Allowable Values:** 21 char max | | data\[].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` | | data\[].fulfillment.card\_personalization.text.name\_line\_2.**value** string Conditionally returned | Line of personalized text printed on the card. **Allowable Values:** 21 char max | | data\[].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` | | data\[].fulfillment.card\_personalization.text.name\_line\_3.**value** string Conditionally returned | Line of personalized text printed on the card. **Allowable Values:** 21 char max | | data\[].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` | | data\[].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 | | data\[].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` | | data\[].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 | | data\[].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. | | data\[].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. | | data\[].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 | | data\[].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/). | | data\[].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 | | data\[].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 | | data\[].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 | | data\[].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 | | data\[].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 | | data\[].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 | | data\[].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 | | data\[].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 | | data\[].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. | | data\[].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. | | data\[].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 | | data\[].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/). | | data\[].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 | | data\[].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 | | data\[].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 | | data\[].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 | | data\[].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 | | data\[].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 | | data\[].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 | | data\[].**name\_line1\_end\_index** integer Conditionally returned | This field is included if your bulk card order has been processed. You can use the `name_line1_start_index` and `name_line1_end_index` fields to identify the cards and users associated with the order. For example, if the start index is "1" and the end index is "3", the card tokens are "card-1", "card-2", and "card-3", and the user tokens are "user-1", "user-2", and "user-3". See [Create bulk card order](https://www.marqeta.com/docs/core-api/bulk-card-orders/create-bulk-card-order.md) for more information about the automatic generation and naming of cards and users. **Allowable Values:** Any positive integer | | data\[].**name\_line1\_start\_index** integer Conditionally returned | This field is included if your bulk card order has been processed. You can use the `name_line1_start_index` and `name_line1_end_index` fields to identify the cards and users associated with the order. For example, if the start index is "1" and the end index is "3", the card tokens are "card-1", "card-2", and "card-3", and the user tokens are "user-1", "user-2", and "user-3". See [Create bulk card order](https://www.marqeta.com/docs/core-api/bulk-card-orders/create-bulk-card-order.md) for more information about the automatic generation and naming of cards and users. **Allowable Values:** Any positive integer | | data\[].**name\_line\_1\_numeric\_postfix** boolean Conditionally returned | If set to `true`, the unique numeric postfix appended to each card's token field is also appended to the card's `fulfillment.card_personalization.text.name_line_1.value` field. **Allowable Values:** `true`, `false` | | data\[].**name\_line\_1\_random\_postfix** boolean Conditionally returned | If set to `true`, the unique random postfix appended to each card's token field is also appended to the card's `fulfillment.card_personalization.text.name_line_1.value` field. This field is returned if it exists in the resource. **Allowable Values:** `true`, `false` | | data\[].**provider\_ship\_date** datetime Conditionally returned | Date and time when the card provider shipped the bulk card order, in UTC. This field is included if your bulk card order has shipped. **Allowable Values:** Format: yyyy-MM-ddThh:mm:ssZ | | data\[].**provider\_shipping\_method** string Conditionally returned | Shipping method used by the card provider. `United_Postal_Service`, for example. This field is included if your bulk card order has shipped. **Allowable Values:** String | | data\[].**provider\_tracking\_number** string Conditionally returned | A tracking number is included only if your card provider is Arroweye Solutions. This field is included if your bulk card order has shipped. **Allowable Values:** String | | data\[].**token** string Returned | Unique identifier of the bulk card order. **Allowable Values:** 1–36 chars | | data\[].**user\_association** object Conditionally returned | Associates each card with a user. **Allowable Values:** `single_inventory_user`, `single_inventory_user_token` | | data\[].user\_association.**single\_inventory\_user** boolean Conditionally returned | Set to `true` to associate all cards with the same user. Set to `false` to associate each card with a different user. When set to `false`, users are generated automatically and associated with the cards. **Allowable Values:** `true`, `false` **Default value:** `false` | | data\[].user\_association.**single\_inventory\_user\_token** string Conditionally returned | If `single_inventory_user=true`, use this field to specify the token of an existing user. All cards in the order will be associated with this user. **Allowable Values:** 1–36 chars | | end\_index integer Conditionally returned | Sort order index of the last resource in the returned array. This field is returned if there are resources in your returned array. **Allowable Values:** Any integer | | is\_more boolean Conditionally returned | A value of `true` indicates that more unreturned resources exist. A value of `false` indicates that no more unreturned resources exist. This field is returned if there are resources in your returned array. **Allowable Values:** `true`, `false` | | start\_index integer Conditionally returned | Sort order index of the first resource in the returned array. This field is returned if there are resources in your returned array. **Allowable Values:** Any integer | ## Sample response body ```json JSON expandable lines wrap theme={null} { "count": 1, "start_index": 0, "end_index": 0, "is_more": true, "data[]": { "token": "bulk_06_token", "expedite": false, "fulfillment": { "shipping": { "method": "UPS_REGULAR", "return_address": { "first_name": "Shipping", "last_name": "R_US", "address1": "1222 Blake Street", "city": "Berkeley", "state": "CA", "postal_code": "94702", "country": "USA", "phone": "5102222222" }, "recipient_address": { "first_name": "Saki", "last_name": "Dogger", "address1": "1255 Lake Street", "city": "Oakland", "state": "CA", "postal_code": "94611", "country": "USA", "phone": "5103333333" }, "card_personalization": { "text": { "name_line_1": { "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" } } }, "card_product_token": "my_card_product_02", "card_allocation": 3, "user_association": { "single_inventory_user": false }, "name_line_1_numeric_postfix": true, "expiration_offset": { "unit": "YEARS", "value": 10 }, "created_time": "2020-08-06T00:06:34Z", "name_line1_start_index": 1, "name_line1_end_index": 3, "card_fulfillment_time": "2022-08-07T23:59:44Z", "provider_ship_date": "2022-08-08T00:00:00Z", "provider_shipping_method": "United_Parcel_Service", "provider_tracking_number": "982247" } }, "api": "bulkissuances", "endpoint": "/bulkissuances", "method": "get", "cp_id": 1, "bc_id": 1 } } ``` ## Related topics - [Bulk Card Orders Overview](https://www.marqeta.com/docs/core-api/bulk-card-orders.md) - [Create bulk card order](https://www.marqeta.com/docs/core-api/bulk-card-orders/create-bulk-card-order.md) - [Retrieve bulk card order](https://www.marqeta.com/docs/core-api/bulk-card-orders/retrieve-bulk-card-order.md) - [Bulk Card Orders Object](https://www.marqeta.com/docs/core-api/bulk-card-orders/bulk-card-orders-object.md) - [Managing Physical Cards](https://www.marqeta.com/docs/developer-guides/managing-physical-cards.md)