Use the https://app.ship.com/public/order/batch endpoint to create multiple shipping orders in one call. Requires the Authorization: Bearer header. Each order object accepts the same fields as single order creation, including the optional customerId. Orders are processed sequentially and are not transactional: if one order in the array fails validation, the response is success:false, but orders earlier in the array have already been created.

Request Parameters

Array of order creation objects. (Same as Order Creation)

Field	Type	Max Length	Required	Description
invoiceNumber	string	-	Yes	Unique invoice identifier
firstName	string	50	Yes	Recipient's first name
lastName	string	50	Yes	Recipient's last name
email	string	100	No	Recipient's email
phone	string	10	No	Recipient's phone number
address1	string	50	Yes	Primary shipping address
address2	string	50	No	Secondary shipping address
city	string	50	Yes	City name
state	string	2	Yes	Two-letter state code
zip	string	5	Yes	Five-digit zip code
country	string	2	Yes	Two-letter country code
total	decimal	-	No	Order total amount
salesTax	decimal	-	No	Sales tax amount
handling	decimal	-	No	Handling fees
subtotal	decimal	-	No	Order subtotal
shipping	decimal	-	No	Shipping cost
weight	decimal	-	No	Order weight
discount	decimal	-	No	Discount amount
items	array	-	Yes	Array of order items

Item Object Structure

Field	Type	Required	Description
itemCode	string	Yes	Unique item identifier
upc	string	No	Universal Product Code
price	decimal	No	Item price
quantity	integer	Yes	Quantity ordered

Request Example

1[
2  {
3      "invoiceNumber": "string",
4      "firstName": "string",
5      "lastName": "string",
6      "email": "string",
7      "phone": "string",
8      "address1": "string",
9      "address2": "string",
10      "city": "string",
11      "state": "string",
12      "zip": "string",
13      "country": "string",
14      "total": 0.00,
15      "salesTax": 0.00,
16      "handling": 0.00,
17      "subtotal": 0.00,
18      "shipping": 0.00,
19      "weight": 0.00,
20      "discount": 0.00,
21      "items": [
22          {
23              "itemCode": "string",
24              "upc": "string",
25              "price": 0.00,
26              "quantity": 0
27          }
28      ]
29  }
30]

Response Structure

Field	Type	Description
success	boolean	Indicates if the request was successful
result	object	Contains the created order details
error	string	Error message if request failed

< Order Creation

Order Creation Objects >

On this page

Order Batch Creation Request Parameters Item Object Structure Request Example Response Structure