An order is a customer’s completed request to purchase one or more products from a shop. An order is created when a customer completes the checkout process, during which time they provides an email address, billing address and payment information.
Access Scopes
`unauthenticated_read_customers` access scope.
Fields
billingAddress:
MailingAddress -
The address associated with the payment method.
cancelReason:
OrderCancelReason -
The reason for the order's cancellation. Returns `null` if the order wasn't canceled.
canceledAt:
DateTime -
The date and time when the order was canceled. Returns null if the order wasn't canceled.
currencyCode:
CurrencyCode! -
The code of the currency used for the payment.
currentSubtotalPrice:
MoneyV2! -
The subtotal of line items and their discounts, excluding line items that have been removed. Does not contain order-level discounts, duties, shipping costs, or shipping discounts. Taxes aren't included unless the order is a taxes-included order.
currentTotalDuties:
MoneyV2 -
The total cost of duties for the order, including refunds.
currentTotalPrice:
MoneyV2! -
The total amount of the order, including duties, taxes and discounts, minus amounts for line items that have been removed.
currentTotalShippingPrice:
MoneyV2! -
The total cost of shipping, excluding shipping lines that have been refunded or removed. Taxes aren't included unless the order is a taxes-included order.
currentTotalTax:
MoneyV2! -
The total of all taxes applied to the order, excluding taxes for returned line items.
customAttributes:
Attribute! -
A list of the custom attributes added to the order. For example, whether an order is a customer's first.
customerLocale:
String -
The locale code in which this specific order happened.
customerUrl:
URL -
The unique URL that the customer can use to access the order.
edited:
Boolean! -
Whether the order has had any edits applied or not.
metafield:
Metafield -
A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information.
metafields:
Metafield! -
A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource.
name:
String! -
Unique identifier for the order that appears on the order.
For example, _#1000_ or _Store1001.
orderNumber:
Int! -
A unique numeric identifier for the order for use by shop owner and customer.
originalTotalDuties:
MoneyV2 -
The total cost of duties charged at checkout.
originalTotalPrice:
MoneyV2! -
The total price of the order before any applied edits.
phone:
String -
The customer's phone number for receiving SMS notifications.
processedAt:
DateTime! -
The date and time when the order was imported.
This value can be set to dates in the past when importing from other systems.
If no value is provided, it will be auto-generated based on current date and time.
shippingAddress:
MailingAddress -
The address to where the order will be shipped.
shippingDiscountAllocations:
DiscountAllocation! -
The discounts that have been allocated onto the shipping line by discount applications.
statusUrl:
URL! -
The unique URL for the order's status page.
subtotalPrice:
MoneyV2 -
Price of the order before shipping and taxes.
subtotalPriceV2:
MoneyV2 -
Price of the order before duties, shipping and taxes.