# Shipments

Shipments are a grouping of one or more line items from one or more orders that are physically packaged and delivered to the Buyer as a single unit. They are typically created by the marketplace owner or supplier after the order is submitted as part of the fulfillment process.

## List shipments

 - [GET /shipments](https://api-docs.sitecore.com/ordercloud/shipments/shipments.list.md)

## Create a shipment

 - [POST /shipments](https://api-docs.sitecore.com/ordercloud/shipments/shipments.create.md)

## Retrieve a shipment

 - [GET /shipments/{shipmentID}](https://api-docs.sitecore.com/ordercloud/shipments/shipments.get.md)

## Create or update a shipment

 - [PUT /shipments/{shipmentID}](https://api-docs.sitecore.com/ordercloud/shipments/shipments.save.md): If an object with the same ID already exists, it will be overwritten.

## Delete a shipment

 - [DELETE /shipments/{shipmentID}](https://api-docs.sitecore.com/ordercloud/shipments/shipments.delete.md)

## Partially update a shipment

 - [PATCH /shipments/{shipmentID}](https://api-docs.sitecore.com/ordercloud/shipments/shipments.patch.md)

## List shipment items

 - [GET /shipments/{shipmentID}/items](https://api-docs.sitecore.com/ordercloud/shipments/shipments.listitems.md)

## Create or update a shipment item

 - [POST /shipments/{shipmentID}/items](https://api-docs.sitecore.com/ordercloud/shipments/shipments.saveitem.md)

## Retrieve a shipment item

 - [GET /shipments/{shipmentID}/items/{orderID}/{lineItemID}](https://api-docs.sitecore.com/ordercloud/shipments/shipments.getitem.md)

## Delete a shipment item

 - [DELETE /shipments/{shipmentID}/items/{orderID}/{lineItemID}](https://api-docs.sitecore.com/ordercloud/shipments/shipments.deleteitem.md)

## Set a ship from address

 - [PUT /shipments/{shipmentID}/shipfrom](https://api-docs.sitecore.com/ordercloud/shipments/shipments.setshipfromaddress.md): Use only when the address is not to be saved/reused. To use a saved address (i.e. from the Addresses resource), PATCH the shipment's FromAddressID property instead.

## Set a ship to address

 - [PUT /shipments/{shipmentID}/shipto](https://api-docs.sitecore.com/ordercloud/shipments/shipments.setshiptoaddress.md): Use only when the address is not to be saved/reused. To use a saved address (i.e. from the Addresses resource), PATCH the shipment's ToAddressID property instead.

