Skip to main content
Skip to main content

Order

An order is a purchase made by a customer. It holds details about payment and fulfillment of the order. An order may also be created from a draft order, which is created by an admin user.

Properties

billing_addressAddressRequired
The details of the billing address associated with the order.
billing_address_idstringRequired
The ID of the billing address associated with the order
canceled_atDateRequired
The date the order was canceled on.
cartCartRequired
The details of the cart associated with the order.
cart_idstringRequired
The ID of the cart associated with the order
claimsClaimOrder[]Required
The details of the claims created for the order.
created_atDateRequired
The date with timezone at which the resource was created.
currencyCurrencyRequired
The details of the currency used in the order.
currency_codestringRequired
The 3 character currency code that is used in the order
customerCustomerRequired
The details of the customer associated with the order.
customer_idstringRequired
The ID of the customer associated with the order
discount_totalnumberRequired
The total of discount rounded
discountsDiscount[]Required
The details of the discounts applied on the order.
display_idnumberRequired
The order's display ID
draft_orderDraftOrderRequired
The details of the draft order this order was created from.
draft_order_idstringRequired
The ID of the draft order this order was created from.
editsOrderEdit[]Required
The details of the order edits done on the order.
emailstringRequired
The email associated with the order
external_idnull | stringRequired
The ID of an external order.
fulfillment_statusFulfillmentStatusRequired
The order's fulfillment status

Default: not_fulfilled

fulfillmentsFulfillment[]Required
The details of the fulfillments created for the order.
gift_card_tax_totalnumberRequired
The total of gift cards with taxes
gift_card_totalnumberRequired
The total of gift cards
gift_card_transactionsGiftCardTransaction[]Required
The gift card transactions made in the order.
gift_cardsGiftCard[]Required
The details of the gift card used in the order.
idstringRequired
The order's ID
idempotency_keystringRequired
Randomly generated key used to continue the processing of the order in case of failure.
item_tax_totalnull | numberRequired
The tax total applied on items
itemsLineItem[]Required
The details of the line items that belong to the order.
metadataRecord<string, unknown>Required
An optional key-value map with additional details
no_notificationbooleanRequired
Flag for describing whether or not notifications related to this should be send.
object"order"Required

Default: "order"

paid_totalnumberRequired
The total amount paid
payment_statusPaymentStatusRequired
The order's payment status

Default: not_paid

paymentsPayment[]Required
The details of the payments used in the order.
raw_discount_totalnumberRequired
The total of discount
refundable_amountnumberRequired
The amount that can be refunded
refunded_totalnumberRequired
The total amount refunded if the order is returned.
refundsRefund[]Required
The details of the refunds created for the order.
regionRegionRequired
The details of the region this order was created in.
region_idstringRequired
The ID of the region this order was created in.
returnable_itemsLineItem[]
The details of the line items that are returnable as part of the order, swaps, or claims
returnsReturn[]Required
The details of the returns created for the order.
sales_channelSalesChannelRequired
The details of the sales channel this order belongs to.
sales_channel_idnull | stringRequired
The ID of the sales channel this order belongs to.
shipping_addressAddressRequired
The details of the shipping address associated with the order.
shipping_address_idstringRequired
The ID of the shipping address associated with the order
shipping_methodsShippingMethod[]Required
The details of the shipping methods used in the order.
shipping_tax_totalnull | numberRequired
The tax total applied on shipping
shipping_totalnumberRequired
The total of shipping
statusOrderStatusRequired
The order's status

Default: pending

subtotalnumberRequired
The subtotal of the order
swapsSwap[]Required
The details of the swaps created for the order.
tax_ratenull | numberRequired
The order's tax rate
tax_totalnull | numberRequired
The total of tax
totalnumberRequired
The total amount of the order
updated_atDateRequired
The date with timezone at which the resource was updated.
Was this section helpful?