> ## 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](/docs/core-api/sorting-and-pagination/).
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. |
| 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. |
| 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 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 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](/docs/core-api/bulk-card-orders.md)
- [Create bulk card order](/docs/core-api/bulk-card-orders/create-bulk-card-order.md)
- [Retrieve bulk card order](/docs/core-api/bulk-card-orders/retrieve-bulk-card-order.md)
- [Bulk Card Orders Object](/docs/core-api/bulk-card-orders/bulk-card-orders-object.md)
- [Managing Physical Cards](/docs/developer-guides/managing-physical-cards.md)