<aside class="access" aria-label="Endpoint access"> <table class="access__table"> <thead> <tr> <th class="access__table-header">Products</th> <th class="access__table-header">Plans</th> </tr> </thead> <tbody> <tr> <td class="access__table-cell access__product"> <img class="access__logo" src="/static/logos/shipstation-api-logo.svg" alt="ShipStation API Logo" loading="lazy" decoding="async"/> <div class="access__sub">Formerly ShipEngine</div> </td> <td class="access__table-cell access__plans"> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-free.md" class="access__plan">Free</a> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Advanced</a> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Enterprise</a> </td> </tr> <tr> <td class="access__table-cell"> <img class="access__logo" src="/static/logos/shipstation-logo.svg" alt="ShipStation Logo" loading="lazy" decoding="async"/> </td> <td class="access__table-cell access__plans"> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Free</a> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Starter</a> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan">Standard</a> <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan">Premium</a> </td> </tr> </tbody> </table> <footer class="access__footer"> <a class="access__help" href="/apis/@shipstation-v2/docs/getting-started/products-and-plans.md"> Learn about products and plans <img src="/static/icons/external-link.svg" alt="External Link Icon" style="width: 16px;" loading="lazy" decoding="async"/> </a> </footer> </aside>

Move items from a shipment into one or more new shipments. Each entry in shipments creates one new shipment holding the items and quantities listed for it. Items and quantities that you don't list stay on the original shipment.

Each new shipment is based on the original shipment and stays linked to the same sales order, so the order source keeps getting shipment notifications after the split.

To split a shipment:

• It must have a shipment_status of pending, awaiting_payment, or on_hold.
• It must be linked to a sales order. Check sales_order_ids on the shipment.
• It can't come from a marketplace that supplies its own shipping labels.
• All of the items you move must belong to the same sales order. To move items from more than one sales order, make one request for each sales order.
• At least one item must stay on the original shipment.

Get the item_id values from the items array of the shipment, using Get shipment by id.

{
  "shipments": [
    {
      "items": [
        {
          "item_id": "1402291169813",
          "quantity": 1
        }
      ]
    }
  ]
}

{
  "shipment_id": "se-28529731",
  "new_shipment_ids": [
    "se-202902301"
  ]
}