> ## 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. # Retrieve bulk card order > Use this endpoint to retrieve a specific bulk card order.

GET/{"bulkissuances"}/{"{token}"}

Use this endpoint to retrieve a specific bulk card order.

URL path parameters

Response body

| Fields | Description | | - | - | | card\_allocation
integer
Returned | Number of cards in the order.

**Allowable Values:**
50000 max | | 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 | | card\_product\_token
string
Returned | Specifies the card product from which the cards are created.

**Allowable Values:**
1–36 chars | | 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 | | 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 | | 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` | | 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` | | 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` | | 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 | | 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` | | fulfillment.**card\_personalization**
object
Returned | Specifies personalized attributes to be added to the card.

**Allowable Values:**
`carrier`, `images`, `perso_type`, `text` | | fulfillment.card\_personalization.**carrier**
object
Conditionally returned | Specifies attributes of the card carrier.

**Allowable Values:**
`logo_file`, `logo_thumbnail_file`, `message_file`, `message_line`, `template_id` | | fulfillment.card\_personalization.carrier.**logo\_file**
string
Conditionally returned | Specifies an image to display on the card carrier.

**Allowable Values:**
Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.carrier.**logo\_thumbnail\_file**
string
Conditionally returned | Specifies a thumbnail-sized rendering of the image specified in the `logo_file` field.

**Allowable Values:**
Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.carrier.**message\_file**
string
Conditionally returned | Specifies a text file containing a custom message to print on the card carrier.

**Allowable Values:**
Contains the name of the text file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.carrier.**message\_line**
string
Conditionally returned | Specifies a custom message that appears on the card carrier.

**Allowable Values:**
60 char max | | fulfillment.card\_personalization.carrier.**template\_id**
string
Conditionally returned | Specifies the card carrier template to use.

**Allowable Values:**
Card carrier template ID | | fulfillment.card\_personalization.**images**
object
Conditionally returned | Specifies personalized images that appear on the card.

**Allowable Values:**
`card`, `carrier`, `carrier_return_window`, `signature` | | fulfillment.card\_personalization.images.**card**
object
Conditionally returned | Specifies personalized images that appear on the card.

**Allowable Values:**
`name`, `thermal_color` | | fulfillment.card\_personalization.images.card.**name**
string
Conditionally returned | Specifies a PNG image to display on the card.

**Allowable Values:**
Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.images.card.**thermal\_color**
string
Conditionally returned | Specifies the color of the image displayed on the card.

**Allowable Values:**
Contains the name of the color and must match one of the provider's predefined colors. | | fulfillment.card\_personalization.images.**carrier**
object
Conditionally returned | Specifies personalized images that appear on the card carrier.

**Allowable Values:**
`message_1`, `name` | | fulfillment.card\_personalization.images.carrier.**message\_1**
string
Conditionally returned | Specifies a custom message that appears on the card carrier.

**Allowable Values:**
60 char max | | fulfillment.card\_personalization.images.carrier.**name**
string
Conditionally returned | Specifies a PNG image to display on the card carrier.

**Allowable Values:**
Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.images.**carrier\_return\_window**
object
Conditionally returned | Specifies a PNG image to display in the return address window of envelopes used for sending cards to cardholders.

**Allowable Values:**
`name` | | fulfillment.card\_personalization.images.carrier\_return\_window.**name**
string
Conditionally returned | Specifies a PNG image to display in the return address window of envelopes used for sending cards to cardholders.

**Allowable Values:**
Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.images.**signature**
object
Conditionally returned | Specifies a PNG image of the cardholder's signature.

**Allowable Values:**
`name` | | fulfillment.card\_personalization.images.signature.**name**
string
Conditionally returned | Specifies a PNG image of the cardholder's signature.

**Allowable Values:**
Contains the name of the image file and must match the name of the file you send to your fulfillment provider. | | fulfillment.card\_personalization.**perso\_type**
string
Conditionally returned | Specifies the type of card personalization.

**Allowable Values:**
`EMBOSS`, `LASER`, `FLAT` | | fulfillment.card\_personalization.**text**
object
Returned | Specifies personalized text that appears on the card.

**Allowable Values:**
`name_line_1`, `name_line_2`, `name_line_3` | | fulfillment.card\_personalization.text.**name\_line\_1**
object
Returned | Specifies the first line of personalized text that appears on the card.

**Allowable Values:**
`name_line_1.value`
21 char max; if `name_line_1_numeric_postfix` is `true`, 14 char max.
Strings longer than the character limit are truncated. | | fulfillment.card\_personalization.text.name\_line\_1.**value**
string
Conditionally returned | Line of personalized text printed on the card.

**Allowable Values:**
21 char max | | fulfillment.card\_personalization.text.**name\_line\_2**
object
Conditionally returned | Specifies the second line of personalized text that appears on the card.

**Allowable Values:**
`name_line_2.value` | | fulfillment.card\_personalization.text.name\_line\_2.**value**
string
Conditionally returned | Line of personalized text printed on the card.

**Allowable Values:**
21 char max | | fulfillment.card\_personalization.text.**name\_line\_3**
object
Conditionally returned | Specifies the third line of personalized text that appears on the card.

**Allowable Values:**
`name_line_3.value` | | fulfillment.card\_personalization.text.name\_line\_3.**value**
string
Conditionally returned | Line of personalized text printed on the card.

**Allowable Values:**
21 char max | | fulfillment.**shipping**
object
Conditionally returned | Specifies shipping details for the order.
This object is returned if it exists in the resource.

**Allowable Values:**
`care_of_line`, `method`, `recipient_address`, `return_address` | | fulfillment.shipping.**care\_of\_line**
string
Conditionally returned | Specifies the value of the care of (C/O) line on the mailing carrier.
This field is returned if it exists in the resource.

**Allowable Values:**
255 char max | | fulfillment.shipping.**method**
string
Conditionally returned | Specifies the shipping service.
This field is returned if it exists in the resource.

**Allowable Values:**
`LOCAL_MAIL`, `LOCAL_MAIL_PACKAGE`, `GROUND`, `TWO_DAY`, `OVERNIGHT`, `INTERNATIONAL`, `INTERNATIONAL_PRIORITY`, `LOCAL_PRIORITY`, `FEDEX_EXPEDITED`, `FEDEX_REGULAR`, `UPS_EXPEDITED`, `UPS_REGULAR`, `USPS_EXPEDITED`, `USPS_REGULAR` | | fulfillment.shipping.**recipient\_address**
object
Conditionally returned | Address to which the order will be shipped.
This field is returned if it exists in the resource.

**Allowable Values:**
Existing `recipient_address` object | | fulfillment.shipping.recipient\_address.**address1**
string
Conditionally returned | Number and street of the address.
This field is returned if it exists in the resource.

**Allowable Values:**
255 char max
Limits lower than 255 characters may be imposed by providers. Perfect Plastic Printing and IDEMIA have a limit of 100 characters, and Arroweye Solutions has a limit of 50 characters. | | fulfillment.shipping.recipient\_address.**address2**
string
Conditionally returned | Additional address information.
This field is returned if it exists in the resource.

**Allowable Values:**
255 char max
Limits lower than 255 characters may be imposed by providers. Perfect Plastic Printing and IDEMIA have a limit of 100 characters, and Arroweye Solutions has a limit of 50 characters. | | fulfillment.shipping.recipient\_address.**city**
string
Conditionally returned | City of the address.
This field is returned if it exists in the resource.

**Allowable Values:**
40 char max | | fulfillment.shipping.recipient\_address.**country**
string
Conditionally returned | Country of the address.
This field is returned if it exists in the resource.

**Allowable Values:**
40 char max
English short name. For example, for the Kingdom of Spain, use the English short name "Spain". The ISO maintains the full list of country codes. | | fulfillment.shipping.recipient\_address.**first\_name**
string
Conditionally returned | First name of the addressee.
This field is returned if it exists in the resource.

**Allowable Values:**
40 char max | | fulfillment.shipping.recipient\_address.**last\_name**
string
Conditionally returned | Last name of the addressee.
This field is returned if it exists in the resource.

**Allowable Values:**
40 char max | | fulfillment.shipping.recipient\_address.**middle\_name**
string
Conditionally returned | Middle name of the addressee.
This field is returned if it exists in the resource.

**Allowable Values:**
40 char max | | fulfillment.shipping.recipient\_address.**phone**
string
Conditionally returned | Telephone number of the addressee.
This field is returned if it exists in the resource.

**Allowable Values:**
20 char max | | fulfillment.shipping.recipient\_address.**postal\_code**
string
Conditionally returned | Postal code of the address.
This field is returned if it exists in the resource.

**Allowable Values:**
10 char max | | fulfillment.shipping.recipient\_address.**state**
string
Conditionally returned | State or province of the address.
This field is returned if it exists in the resource.

**Allowable Values:**
32 char max | | fulfillment.shipping.recipient\_address.**zip**
string
Conditionally returned | United States ZIP code of the address.
This field is returned if it exists in the resource.

**Allowable Values:**
10 char max | | fulfillment.shipping.**return\_address**
object
Conditionally returned | Address to which the order will be returned if shipping fails.
This object is returned if it exists in the resource.

**Allowable Values:**
Existing `return_address` object | | fulfillment.shipping.return\_address.**address1**
string
Conditionally returned | Number and street of the address.
This field is returned if it exists in the resource.

**Allowable Values:**
255 char max
Limits lower than 255 characters may be imposed by providers. Perfect Plastic Printing and IDEMIA have a limit of 100 characters, and Arroweye Solutions has a limit of 50 characters. | | fulfillment.shipping.return\_address.**address2**
string
Conditionally returned | Additional address information.
This field is returned if it exists in the resource.

**Allowable Values:**
255 char max
Limits lower than 255 characters may be imposed by providers. Perfect Plastic Printing and IDEMIA have a limit of 100 characters, and Arroweye Solutions has a limit of 50 characters. | | fulfillment.shipping.return\_address.**city**
string
Conditionally returned | City of the address.
This field is returned if it exists in the resource.

**Allowable Values:**
40 char max | | fulfillment.shipping.return\_address.**country**
string
Conditionally returned | Country of the address.
This field is returned if it exists in the resource.

**Allowable Values:**
40 char max
English short name. For example, for the Kingdom of Spain, use the English short name "Spain". The ISO maintains the full list of country codes. | | fulfillment.shipping.return\_address.**first\_name**
string
Conditionally returned | First name of the addressee.
This field is returned if it exists in the resource.

**Allowable Values:**
40 char max | | fulfillment.shipping.return\_address.**last\_name**
string
Conditionally returned | Last name of the addressee.
This field is returned if it exists in the resource.

**Allowable Values:**
40 char max | | fulfillment.shipping.return\_address.**middle\_name**
string
Conditionally returned | Middle name of the addressee.
This field is returned if it exists in the resource.

**Allowable Values:**
40 char max | | fulfillment.shipping.return\_address.**phone**
string
Conditionally returned | Telephone number of the addressee.
This field is returned if it exists in the resource.

**Allowable Values:**
20 char max | | fulfillment.shipping.return\_address.**postal\_code**
string
Conditionally returned | Postal code of the address.
This field is returned if it exists in the resource.

**Allowable Values:**
10 char max | | fulfillment.shipping.return\_address.**state**
string
Conditionally returned | State or province of the address.
This field is returned if it exists in the resource.

**Allowable Values:**
32 char max | | fulfillment.shipping.return\_address.**zip**
string
Conditionally returned | United States ZIP code of the address.
This field is returned if it exists in the resource.

**Allowable Values:**
10 char max | | 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 | | 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 | | 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` | | 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` | | 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 | | 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 | | 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 | | token
string
Returned | Unique identifier of the bulk card order.

**Allowable Values:**
1–36 chars | | user\_association
object
Conditionally returned | Associates each card with a user.

**Allowable Values:**
`single_inventory_user`, `single_inventory_user_token` | | 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` | | 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 |

Sample response body

```json JSON expandable lines wrap theme={null} { "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": "510-333-3333" } }, "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": "2022-03-06T00:06:34Z", "name_line1_start_index": 1, "name_line1_end_index": 3, "card_fulfillment_time": "2022-03-07T23:59:44Z", "provider_ship_date": "2022-03-08T00:00:00Z", "provider_shipping_method": "United_Parcel_Service", "provider_tracking_number": "982247", "api": "bulkissuances", "endpoint": "/bulkissuances/{token}", "method": "get", "cp_id": 1, "bc_id": 1 } ``` ## Related topics - [Bulk Card Orders Overview](/docs/core-api/bulk-card-orders.md) - [List bulk card orders](/docs/core-api/bulk-card-orders/list-bulk-card-orders.md) - [Bulk Card Orders Object](/docs/core-api/bulk-card-orders/bulk-card-orders-object.md) - [Create bulk card order](/docs/core-api/bulk-card-orders/create-bulk-card-order.md) - [Managing Physical Cards](/docs/developer-guides/managing-physical-cards.md)