Sign in

v66

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

Get bulk order

Retrieve a specific bulk order by token

get/v1/card_bulk_orders/{bulk_order_token}

Path parameters

bulk_order_tokenstring uuid required

Globally unique identifier for the bulk order

Response

OK

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"
}