SHshipstation
shipments

Merge shipments

Changed on
<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>

Merge one or more shipments into the shipment in the URL. The items from each shipment in shipment_ids move onto the shipment in the URL, and the shipments in shipment_ids are then deleted.

The shipment in the URL stays linked to its own sales orders and becomes linked to the sales orders of every shipment merged into it, so order sources keep getting shipment notifications. The merged shipments can belong to different sales orders.

To merge shipments:

  • Every shipment, including the one in the URL, must have a shipment_status of pending, awaiting_payment, or on_hold.
  • Every shipment must be linked to a sales order. Check sales_order_ids on each shipment.
  • None of the shipments can come from a marketplace that supplies its own shipping labels.

If shipment_ids includes the shipment in the URL or lists a shipment more than once, the extra entries are ignored.

post/v2/shipments/{shipment_id}/merge

Request

  • Base URL
    https://api.shipstation.com
  • URL
    https://api.shipstation.com/v2/shipments/{shipment_id}/merge
  • Auth
    API key in header api-key

Request body

shipment_idsSeId[] required

The shipments to merge into the shipment in the URL. At least one of them must be a shipment other than the one in the URL.

Example request

{
  "shipment_ids": [
    "se-202902301",
    "se-202902302"
  ]
}

Response

The shipments were merged.

shipment_idstring

A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc.

merged_shipment_idsSeId[]

The shipments that were merged in. These shipments have been deleted.

Example response

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

Changes