---
title: "Create bulk order"
method: POST
path: "/v1/card_bulk_orders"
tags: ["Card Bulk Orders"]
---

# Create bulk order

`POST /v1/card_bulk_orders`

Create a new bulk order for physical card shipments. Cards can be added to the order via the POST /v1/cards endpoint by specifying the bulk_order_token. Lock the order via PATCH /v1/card_bulk_orders/{bulk_order_token} to prepare for shipment. Please work with your Customer Success Manager and card personalization bureau to ensure bulk shipping is supported for your program.

## Request body

- CreateBulkOrderRequest — Request to create a new bulk order for physical card shipments. Please work with your Customer Success Manager and card personalization bureau to ensure bulk shipping is supported for your program.
  - `shipping_address` object, required — Shipping address for all cards in this bulk order
  - `shipping_method` 'BULK_EXPEDITED' | 'BULK_PRIORITY' | 'BULK_2_DAY' | 'BULK_EXPRESS', required — Shipping method for all cards in this bulk order. BULK_PRIORITY, BULK_2_DAY, and BULK_EXPRESS are only available with Perfect Plastic Printing
  - `customer_product_id` string, required — Customer-specified product configuration for physical card manufacturing. This must be configured with Lithic before use

## Response `201`

Created

- BulkOrderResponse — Represents a bulk order for physical card shipments
  - `token` string, uuid, required — Globally unique identifier for the bulk order
  - `status` 'OPEN' | 'LOCKED', required — Status of the bulk order. OPEN indicates the order is accepting cards. LOCKED indicates the order is finalized and no more cards can be added
  - `shipping_address` object, required — Shipping address for all cards in this bulk order
  - `shipping_method` 'BULK_EXPEDITED' | 'BULK_PRIORITY' | 'BULK_2_DAY' | 'BULK_EXPRESS', required — Shipping method for all cards in this bulk order. BULK_PRIORITY, BULK_2_DAY, and BULK_EXPRESS are only available with Perfect Plastic Printing
  - `customer_product_id` string, nullable, required — Customer-specified product configuration for physical card manufacturing. This must be configured with Lithic before use
  - `card_tokens` string[], required — List of card tokens associated with this bulk order
  - `created` string, date-time, required — An RFC 3339 timestamp for when the bulk order was created. UTC time zone
  - `updated` string, date-time, required — An RFC 3339 timestamp for when the bulk order was last updated. UTC time zone

## Other responses

- `400` — A parameter in the query given in the request does not match the valid queries for the endpoint.
- `401` — | | | |---|---| | User has not been authenticated | Invalid or missing API key | | API key is not active | The API key used is no longer active | | Could not find API key | The API key provided is not associated with any user | | Please provide API key in Authorization header | The Authorization header is not in the request | | Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly | | Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at [lithic.com/contact](https://lithic.com/contact) | | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege | Reach out at [lithic.com/contact](https://lithic.com/contact) |
- `429` — Client has exceeded the number of allowed requests in a given time period. | | | |---|---| | Rate limited, too many requests per second | User has exceeded their per second rate limit | | Rate limited, reached daily limit | User has exceeded their daily rate limit | | Rate limited, too many keys tried | One IP has queried too many different API keys |

---

[API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/revisions/53ab5d4e2adb/schema)