Bulk Shipping

Overview

Customers are now able to use a bulk_order_token to ship multiple cards together to a single location. Please work with your Customer Success Manager and card personalization bureau to ensure bulk shipping is supported for your program.

Details

Learn more in our Bulk Shipping Physical Cards guide.

New Endpoints

• Create Bulk Order - Creates a new bulk order with shipping address details
• Update Bulk Order - Signals all cards have been added and order is ready for fulfillment. Once locked, the bulk_order_token can no longer be used to add cards
• Retrieve Bulk Order - Returns all cards in the order with bulk shipping details. Includes bulk_order_status and shipping information.
• List Bulk Orders - Lists all bulk orders

Updated Endpoints

• Create Card
  • Added optional bulk_order_token field to group cards into bulk shipments. Cards with bulk_order_token populated will be added to the same issuance files only when the bulk order status is OPEN
  • Added shipping_method option of BULK_EXPEDITED - FedEx Standard Overnight or similar
• Get Card - Response now includes bulk_order_token if present
• List Cards - Response now includes bulk_order_token if present

Webhook Updates

• cards.shipped event - Now includes bulk_order_token field when card is part of a bulk order

Examples

First, will Create the Bulk Order with following request: POST /v1/card_bulk_orders

{
  "shipping_address": {
    "address1": "string",
    "address2": "string",
    "city": "string",
    "country": "string",
    "first_name": "string",
    "last_name": "string",
    "postal_code": "string",
    "state": "string",
    "email": "string",
    "phone_number": "string"
  },
  "shipping_method": "string",
  "external_id": "string",
  "product_id": "string"
}

We will return the bulk_order_token and the bulk_order_status as OPEN

{
  "token": "uuid",
  "status": "string",
  "external_id": "string",
  "product_id": "string",
  "card_tokens": [
    "uuid",
    ...
  ],
  "shipping_method": "string",
  "shipping_address": {
    "address1": "string",
    "address2": "string",
    "city": "string",
    "country": "string",
    "first_name": "string",
    "last_name": "string",
    "postal_code": "string",
    "state": "string",
    "email": "string",
    "phone_number": "string"
  },
}

Next, Create Cards using the POST /v1/cards endpoint. Add the bulk_order_token for all cards that should be included in the single shipping location. The shipping_method will be BULK_EXPEDITED

Lastly, Lock the Bulk Order with PATCH /v1/bulk_orders/{bulk_order_token}/lock

{
  "type": "string"  // LOCKED
}

We will return the following response. All of the cards created using the now LOCKED bulk_order_token will run through the standard fulfilment process and be sent together to the card personalization bureau to be fulfilled and shipped in bulk to the requested bulk shipping address.

{
  "token": "uuid",
  "status": "string",
  "external_id": "string",
  "product_id": "string",
  "card_tokens": [
    "uuid",
    ...
  ],
  "shipping_method": "string",
  "shipping_address": {
    "address1": "string",
    "address2": "string",
    "city": "string",
    "country": "string",
    "first_name": "string",
    "last_name": "string",
    "postal_code": "string",
    "state": "string"
  },
}

Release Timeline

Available now: November 26, 2025

User Impact

No impact, this change is additive only.

If you have any questions or concerns, please contact us via the HELP link in your Lithic Dashboard.

The Lithic changelog has an RSS feed! To monitor for new update announcements, subscribe with your preferred RSS reader.