Order

Represents a placed order, exposing order details, totals, items, discounts, shipping, and payment information.

Type Definition


type Order {
  id: String
  orderNumber: String
  referenceNumber: String
  createdAt: String
  orderStatus: String
  financialStatus: String
  isFulfilled: Boolean
  isShipped: Boolean
  isCancelled: Boolean
  customer: Customer
  discounts: [CartDiscount]
  tags: [String]
  subtotalPrice: Float
  totalPrice: Float
  currency: String
  totalNetPrice: Float
  totalTax: Float
  taxLines: [CartTaxLine]
  customerNote: String
  paymentMethods: [CartPaymentMethod]
  paymentFee: Float
  shippingMethods: [CartShippingMethod]
  shippingPrice: Float
  lines: [CartLineItem]
  physicalLines: [CartLineItem]
  lineCount: Int
  shippingAddress: Address
  billingAddress: Address
  metafields: [Metafield]!
  metafield: Metafield
}

Fields

Field	Type	Description
id	String	Returns the id for this order.
orderNumber	String	Returns the order number.
referenceNumber	String	Returns the reference number.
createdAt	String	Date when this order was created in RFC 2822 format.
orderStatus	String	Returns the order status.
financialStatus	String	Returns paid if order is paid, otherwise not_paid.
isFulfilled	Boolean	Returns true if order is fulfilled.
isShipped	Boolean	Returns true if order is shipped.
isCancelled	Boolean	Returns true if this order was cancelled.
customer	Customer	Customer linked to this order if any.
discounts	[CartDiscount]	Returns the discounts applied to this order.
tags	[String]	Returns the tags associated with this order.
subtotalPrice	Float	Returns the subtotal in customer’s currency.
totalPrice	Float	Returns the total in customer’s currency.
currency	String	Returns the currency for this order.
totalNetPrice	Float	Returns the net total in customer’s currency.
totalTax	Float	Returns the total tax in customer’s currency.
taxLines	[CartTaxLine]	Returns the tax lines for this order.
customerNote	String	Returns the customer note.
paymentMethods	[CartPaymentMethod]	Returns the payment methods for this order.
paymentFee	Float	Returns the total payment fee in customer’s currency.
shippingMethods	[CartShippingMethod]	Returns the shipping methods for this order.
shippingPrice	Float	Returns the total shipping costs in customer’s currency.
lines	[CartLineItem]	Returns the items in this order.
physicalLines	[CartLineItem]	Returns the physical items in this order.
lineCount	Int	Returns the number of items in this order.
shippingAddress	Address	Returns the shipping address for this order.
billingAddress	Address	Returns the billing address for this order.
metafields	[Metafield]!	Metafields stored on this resource.
metafield	Metafield	A single metafield by namespace and key.

Relationships

The Order type represents a placed order containing comprehensive order information. It relates to the Customer type for customer details associated with the order. Order discounts are represented through the CartDiscount type, while tax information is provided by CartTaxLine. Payment details are accessible via the CartPaymentMethod type, and shipping information is provided through the CartShippingMethod type. Line items in the order are represented by CartLineItem objects. The order’s shipping and billing addresses are represented by the Address type. Additional custom data can be stored using Metafield objects.

Example


query {
  order {
    id
    orderNumber
    referenceNumber
    createdAt
    orderStatus
    financialStatus
    isFulfilled
    isShipped
    isCancelled
    totalPrice
    currency
    subtotalPrice
    totalTax
    shippingPrice
    lineCount
    customer {
      id
      firstName
      lastName
    }
    lines {
      id
      quantity
    }
    shippingAddress {
      id
      city
      country
    }
    billingAddress {
      id
      city
      country
    }
  }
}

Implements

This type does not implement any interfaces.