Sign in

v66

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-042174421.1 MB
Card Bulk Orders

Create bulk order

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.

post/v1/card_bulk_orders

Request body

shipping_addressobject 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_idstring required

Customer-specified product configuration for physical card manufacturing. This must be configured with Lithic before use

Example request

{
  "customer_product_id": "custom-card-design-123"
}

Response

Created

tokenstring 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_addressobject 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_idstring nullable required

Customer-specified product configuration for physical card manufacturing. This must be configured with Lithic before use

card_tokensstring[] required

List of card tokens associated with this bulk order

createdstring date-time required

An RFC 3339 timestamp for when the bulk order was created. UTC time zone

updatedstring date-time required

An RFC 3339 timestamp for when the bulk order was last updated. UTC time zone

Example response

{
  "token": "7ef7d65c-9023-4da3-b113-3b8583fd7951",
  "customer_product_id": "custom-card-design-123",
  "created": "2021-06-28T22:53:15Z",
  "updated": "2021-06-28T22:53:15Z"
}