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

idstringRequired
The order's ID
created_atDateRequired
The date with timezone at which the resource was created.
updated_atDateRequired
The date with timezone at which the resource was updated.
object"order"Required

Default: "order"

statusOrderStatusRequired
The order's status

Default: pending

fulfillment_statusFulfillmentStatusRequired
The order's fulfillment status

Default: not_fulfilled

payment_statusPaymentStatusRequired
The order's payment status

Default: not_paid

display_idnumberRequired
The order's display ID
cart_idstringRequired
The ID of the cart associated with the order
cartCartRequired
The details of the cart associated with the order.
customer_idstringRequired
The ID of the customer associated with the order
customerCustomerRequired
The details of the customer associated with the order.
emailstringRequired
The email associated with the order
billing_address_idstringRequired
The ID of the billing address associated with the order
billing_addressAddressRequired
The details of the billing address associated with the order.
shipping_address_idstringRequired
The ID of the shipping address associated with the order
shipping_addressAddressRequired
The details of the shipping address associated with the order.
region_idstringRequired
The ID of the region this order was created in.
regionRegionRequired
The details of the region this order was created in.
currency_codestringRequired
The 3 character currency code that is used in the order
currencyCurrencyRequired
The details of the currency used in the order.
tax_ratenull | numberRequired
The order's tax rate
discountsDiscount[]Required
The details of the discounts applied on the order.
gift_cardsGiftCard[]Required
The details of the gift card used in the order.
shipping_methodsShippingMethod[]Required
The details of the shipping methods used in the order.
paymentsPayment[]Required
The details of the payments used in the order.
fulfillmentsFulfillment[]Required
The details of the fulfillments created for the order.
returnsReturn[]Required
The details of the returns created for the order.
claimsClaimOrder[]Required
The details of the claims created for the order.
refundsRefund[]Required
The details of the refunds created for the order.
swapsSwap[]Required
The details of the swaps created for the order.
draft_order_idstringRequired
The ID of the draft order this order was created from.
draft_orderDraftOrderRequired
The details of the draft order this order was created from.
editsOrderEdit[]Required
The details of the order edits done on the order.
itemsLineItem[]Required
The details of the line items that belong to the order.
gift_card_transactionsGiftCardTransaction[]Required
The gift card transactions made in the order.
canceled_atDateRequired
The date the order was canceled on.
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.
idempotency_keystringRequired
Randomly generated key used to continue the processing of the order in case of failure.
external_idnull | stringRequired
The ID of an external order.
sales_channel_idnull | stringRequired
The ID of the sales channel this order belongs to.
sales_channelSalesChannelRequired
The details of the sales channel this order belongs to.
shipping_totalnumberRequired
The total of shipping
shipping_tax_totalnull | numberRequired
The tax total applied on shipping
discount_totalnumberRequired
The total of discount rounded
raw_discount_totalnumberRequired
The total of discount
item_tax_totalnull | numberRequired
The tax total applied on items
tax_totalnull | numberRequired
The total of tax
refunded_totalnumberRequired
The total amount refunded if the order is returned.
totalnumberRequired
The total amount of the order
subtotalnumberRequired
The subtotal of the order
paid_totalnumberRequired
The total amount paid
refundable_amountnumberRequired
The amount that can be refunded
gift_card_totalnumberRequired
The total of gift cards
gift_card_tax_totalnumberRequired
The total of gift cards with taxes
sales_channelsSalesChannel[]
The associated sales channels.
returnable_itemsLineItem[]
The details of the line items that are returnable as part of the order, swaps, or claims
Was this section helpful?