orderId |
number |
The system generated identifier for the order. This is a read-only field. |
orderNumber |
string |
A user-defined order number used to identify an order. |
orderKey |
string |
A user-provided key that should be unique to each order. Can only be initialized during order creation. If the orderkey isn't specified during creation, a unique value will be generated and assigned to the order. |
orderDate |
string |
The date the order was placed. |
createDate |
string |
The timestamp the order was created in ShipStation's database. Read-Only. |
modifyDate |
string |
The timestamp the order was modified in ShipStation. modifyDate will equal createDate until a modification is made. Read-Only. |
paymentDate |
string |
The date the order was paid for. |
shipByDate |
string |
The date the order is to be shipped before or on. This field is a suggested value generated by the order source/platform/cart and passed to ShipStation. Not all ShipStation integrations support this field and will show null if absent. |
orderStatus |
string |
The order's status. Possible values: "awaiting_payment", "awaiting_shipment", "shipped", "on_hold", "cancelled" |
customerId |
number |
Unique identifier for the customer. Generated by ShipStation the first time the customer record is created. Read-Only |
customerUsername |
string |
Identifier for the customer in the originating system. This is typically a username or email address. This value is required in order to generate a customer profile |
customerEmail |
string |
The customer's email address. |
billTo |
Address |
The recipients billing address. |
shipTo |
Address |
The recipients shipping address. |
items |
OrderItem |
Array of purchased items. |
orderTotal |
number |
The order total. Please note is this a read-only field. |
amountPaid |
number |
The total amount paid for the Order. |
taxAmount |
number |
The total tax amount for the Order. |
shippingAmount |
number |
Shipping amount paid by the customer, if any. |
customerNotes |
string |
Notes left by the customer when placing the order. |
internalNotes |
string |
Private notes that are only visible to the seller. |
gift |
boolean |
Specifies whether or not this Order is a gift |
giftMessage |
string |
Gift message left by the customer when placing the order. |
paymentMethod |
string |
Method of payment used by the customer. |
requestedShippingService |
string |
Identifies the shipping service selected by the customer when placing this order. This value is given to ShipStation by the marketplace/cart. If value is "null" then the marketplace or cart does not support this field in ShipStation. |
carrierCode |
string |
The code for the carrier that is to be used(or was used) when this order is shipped(was shipped). |
serviceCode |
string |
The code for the shipping service that is to be used(or was used) when this order is shipped(was shipped). |
packageCode |
string |
The code for the package type that is to be used(or was used) when this order is shipped(was shipped). |
confirmation |
string |
The type of delivery confirmation that is to be used(or was used) when this order is shipped(was shipped). |
shipDate |
string |
The date the order was shipped. |
holdUntilDate |
string |
If placed on hold, this date is the expiration date for this order's hold status. The order is moved back to awaiting_shipment on this date. |
weight |
Weight |
Weight of the order. |
dimensions |
Dimensions |
Dimensions of the order. |
insuranceOptions |
InsuranceOptions |
The shipping insurance information associated with this order. |
internationalOptions |
InternationalOptions |
Customs information that can be used to generate customs documents for international orders. |
advancedOptions |
AdvancedOptions |
Various advanced options that may be available depending on the shipping carrier that is used to ship the order. |
tagIds |
number |
Array of tagIds. Each tagId identifies a tag that has been associated with this order. See also Add Tag to Order, List Orders by Tag, Remove Tag from Order, Product Tag, and List Products. |
userId |
string |
User assigned to Order/Shipment in the GUID. Read-Only. |
externallyFulfilled |
boolean |
States whether the order has is current marked as externally fulfilled by the marketplace. A common example is when an Amazon order is marked an Amazon Fulfilled Network (AFN). If the order is an AFN then this element will be true. Read-Only. |
externallyFulfilledBy |
string |
If externallFulfilled is true then this string will return how the order is being fulfilled by the marketplace. Read-Only. |