Order
Requires access scope.
A customer’s completed request to purchase one or more products from a shop. Apps using the Customer Account API must meet the protected customer data requirements.
Anchor to FieldsFields
- agreements (SalesAgreementConnection!)
- billingAddress (CustomerAddress)
- cancelledAt (DateTime)
- cancelReason (OrderCancelReason)
- confirmationNumber (String)
- createdAt (DateTime!)
- currencyCode (CurrencyCode!)
- customer (Customer)
- customerLocale (String)
- discountApplications (DiscountApplicationConnection!)
- draftOrder (DraftOrder)
- edited (Boolean!)
- email (String)
- financialStatus (OrderFinancialStatus)
- fulfillments (FulfillmentConnection!)
- fulfillmentStatus (OrderFulfillmentStatus!)
- id (ID!)
- lineItems (LineItemConnection!)
- locationName (String)
- metafield (Metafield)
- metafields ([Metafield]!)
- name (String!)
- note (String)
- number (Int!)
- paymentInformation (OrderPaymentInformation)
- phone (String)
- poNumber (String)
- processedAt (DateTime!)
- purchasingEntity (PurchasingEntity)
- refunds ([Refund!]!)
- requiresShipping (Boolean!)
- returnInformation (OrderReturnInformation!)
- returns (ReturnConnection!)
- shippingAddress (CustomerAddress)
- shippingDiscountAllocations ([DiscountAllocation!]!)
- shippingLine (ShippingLine)
- statusPageUrl (URL!)
- subscriptionContracts (SubscriptionContractConnection)
- subtotal (MoneyV2)
- totalDuties (MoneyV2)
- totalPrice (MoneyV2!)
- totalRefunded (MoneyV2!)
- totalShipping (MoneyV2!)
- totalTax (MoneyV2)
- totalTip (MoneyV2)
- transactions ([OrderTransaction!]!)
- updatedAt (DateTime!)
- Anchor to agreementsagreements•Sales
Agreement Connection! non-null A list of sales agreements associated with the order.
Show fields
- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
Arguments
- Anchor to billingAddressbilling•Customer
Address Address The mailing address provided by the customer. Not all orders have a mailing address.
Show fields
- Anchor to cancelledAtcancelled•Date
At Time The date and time when the order was canceled. Returns
nullif the order wasn't canceled.- Anchor to cancelReasoncancel•Order
Reason Cancel Reason The reason for the cancellation of the order. Returns
nullif the order wasn't canceled.Show enum values
- Anchor to confirmationNumberconfirmation•String
Number A randomly generated alpha-numeric identifier for the order that may be shown to the customer instead of the sequential order name. For example, "XPAV284CT", "R50KELTJP" or "35PKUN0UJ". This value isn't guaranteed to be unique.
- Anchor to createdAtcreated•Date
At Time! non-null The date and time when the order was created.
- Anchor to currencyCodecurrency•Currency
Code Code! non-null The shop currency when the order was placed.
Show enum values
- Anchor to customercustomer•Customer
The customer who placed the order.
Show fields
- Anchor to customerLocalecustomer•String
Locale The locale code representing the region where this specific order was placed.
- Anchor to discountApplicationsdiscount•Discount
Applications Application Connection! non-null The discounts that have been applied to the order.
Show fields
- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
Arguments
- Anchor to draftOrderdraft•Draft
Order Order The draft order associated with the order.
Show fields
- Anchor to editededited•Boolean!non-null
Whether the order has been edited or not.
- Anchor to emailemail•String
The email address of the customer.
- Anchor to financialStatusfinancial•Order
Status Financial Status The financial status of the order.
Show enum values
- Anchor to fulfillmentsfulfillments•Fulfillment
Connection! non-null The fulfillments associated with the order.
Show fields
- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to queryquery•String
A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about Shopify API search syntax.
- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
- Anchor to sortKeysort•Fulfillment
Key Sort Keys Default:ID Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.
Show enum values
Arguments
- Anchor to fulfillmentStatusfulfillment•Order
Status Fulfillment Status! non-null The fulfillment status of the order.
Show enum values
- •ID!non-null
A globally-unique ID.
- Anchor to lineItemsline•Line
Items Item Connection! non-null The list of line items of the order.
Show fields
- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
Arguments
- Anchor to locationNamelocation•String
Name The name of the fulfillment location assigned at the time of order creation.
- Anchor to metafieldmetafield•Metafield
A metafield found by namespace and key.
Show fields
- •String!required
The identifier for the metafield.
- Anchor to namespacenamespace•String!required
A container for a set of metafields.
Arguments
- •String!
- Anchor to metafieldsmetafields•[Metafield]!non-null
The metafields associated with the resource matching the supplied list of namespaces and keys.
Show fields
- Anchor to identifiersidentifiers•[Has
Metafields Identifier!]! required The list of metafields to retrieve by namespace and key.
Show input fields
Arguments
- Anchor to namename•String!non-null
The identifier for the order that appears on the order. For example, #1000 or _Store1001.
- Anchor to notenote•String
The order's notes.
- Anchor to numbernumber•Int!non-null
A unique numeric identifier for the order, used by both the shop owner and customer.
- Anchor to paymentInformationpayment•Order
Information Payment Information The payment information for the order.
Show fields
- Anchor to phonephone•String
The phone number of the customer for SMS notifications.
- Anchor to poNumberpo•String
Number The purchase order number of the order.
- Anchor to processedAtprocessed•Date
At Time! non-null The date and time when the order was processed. 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.
- Anchor to purchasingEntitypurchasing•Purchasing
Entity Entity The purchasing entity for the order.
Show union types
- Anchor to refundsrefunds•[Refund!]!non-null
A list of refunds associated with the order.
Show fields
- Anchor to requiresShippingrequires•Boolean!
Shipping non-null Whether the order requires shipping.
- Anchor to returnInformationreturn•Order
Information Return Information! non-null The return information for the order.
Show fields
- Anchor to returnsreturns•Return
Connection! non-null The list of returns for the order with pagination.
Show fields
- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
- Anchor to sortKeysort•Return
Key Sort Keys Default:ID Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.
Show enum values
Arguments
- Anchor to shippingAddressshipping•Customer
Address Address The mailing address to which the order items are shipped.
Show fields
- Anchor to shippingDiscountAllocationsshipping•[Discount
Discount Allocations Allocation!]! non-null The discounts that have been allocated onto the shipping line by discount applications.
Show fields
- Anchor to shippingLineshipping•Shipping
Line Line A summary of all shipping costs on the order.
Show fields
- Anchor to statusPageUrlstatus•URL!
Page Url non-null The unique URL for the status page of the order.
- Anchor to subscriptionContractssubscription•Subscription
Contracts Contract Connection The customer Subscription Contracts associated with the order.
Show fields
- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to queryquery•String
A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about Shopify API search syntax.
- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
- Anchor to sortKeysort•Subscription
Key Contracts Sort Keys Default:CREATED_AT Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.
Show enum values
Arguments
- Anchor to subtotalsubtotal•Money
V2 The price of the order before duties, shipping, and taxes.
Show fields
- Anchor to totalDutiestotal•Money
Duties V2 The total amount of duties after returns.
Show fields
- Anchor to totalPricetotal•Money
Price V2! non-null The total amount of the order (including taxes and discounts) minus the amounts for line items that have been returned.
Show fields
- Anchor to totalRefundedtotal•Money
Refunded V2! non-null The total amount refunded.
Show fields
- Anchor to totalShippingtotal•Money
Shipping V2! non-null The total cost of shipping.
Show fields
- Anchor to totalTaxtotal•Money
Tax V2 The total cost of taxes.
Show fields
- Anchor to totalTiptotal•Money
Tip V2 The total value of tips.
Show fields
- Anchor to transactionstransactions•[Order
Transaction!]! non-null A list of transactions associated with the order.
Show fields
- Anchor to updatedAtupdated•Date
At Time! non-null The date and time when the order was last updated.
Anchor to QueriesQueries
- order (Order)
- •query
Returns an Order resource by ID. Apps using the Customer Account API must meet the protected customer data requirements.
Show fields
- •ID!required
The ID of the Order to return.
Arguments
- •ID!