Order

Required access

unauthenticated_read_customers access scope

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.

Show definition
# 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.
type Order implements Node {
  # Globally unique identifier.
  id: ID!

  # The code of the currency used for the payment.
  currencyCode: CurrencyCode!

  # The locale code in which this specific order happened.
  customerLocale: String

  # The unique URL that the customer can use to access the order.
  customerUrl: URL

  # The customer's email address.
  email: String

  # List of the order’s line items.
  lineItems(
    # Returns up to the first `n` elements from the list.
    first: Int

    # Returns the elements that come after the specified cursor.
    after: String

    # Returns up to the last `n` elements from the list.
    last: Int

    # Returns the elements that come before the specified cursor.
    before: String

    # Reverse the order of the underlying list.
    reverse: Boolean = false
  ): OrderLineItemConnection!

  # A unique numeric identifier for the order for use by shop owner and customer.
  orderNumber: Int!

  # The customer's phone number.
  phone: String

  # 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.
  processedAt: DateTime!

  # The address to where the order will be shipped.
  shippingAddress: MailingAddress

  # The unique URL for the order's status page.
  statusUrl: URL!

  # Price of the order before shipping and taxes.
  subtotalPrice: Money

  # The sum of all the prices of all the items in the order, taxes and discounts included (must be positive).
  totalPrice: Money!

  # The total amount that has been refunded.
  totalRefunded: Money!

  # The total cost of shipping.
  totalShippingPrice: Money!

  # The total cost of taxes.
  totalTax: Money
}

Implements

Connections

lineItems   (OrderLineItemConnection!)

List of the order’s line items.

Required access

unauthenticated_read_ access scope

Argument Type Default Description
after

String

Returns the elements that come after the specified cursor.

before

String

Returns the elements that come before the specified cursor.

first

Int

Returns up to the first n elements from the list.

last

Int

Returns up to the last n elements from the list.

reverse

Boolean

false

Reverse the order of the underlying list.

Fields

currencyCode   (CurrencyCode!)

The code of the currency used for the payment.

Required access

unauthenticated_read_ access scope

customerLocale   (String)

The locale code in which this specific order happened.

Required access

unauthenticated_read_ access scope

customerUrl   (URL)

The unique URL that the customer can use to access the order.

Required access

unauthenticated_read_ access scope

email   (String)

The customer's email address.

Required access

unauthenticated_read_ access scope

id   (ID!)

Globally unique identifier.

Required access

unauthenticated_read_ access scope

orderNumber   (Int!)

A unique numeric identifier for the order for use by shop owner and customer.

Required access

unauthenticated_read_ access scope

phone   (String)

The customer's phone number.

Required access

unauthenticated_read_ access scope

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.

Required access

unauthenticated_read_ access scope

shippingAddress   (MailingAddress)

The address to where the order will be shipped.

Required access

unauthenticated_read_ access scope

statusUrl   (URL!)

The unique URL for the order's status page.

Required access

unauthenticated_read_ access scope

subtotalPrice   (Money)

Price of the order before shipping and taxes.

Required access

unauthenticated_read_ access scope

totalPrice   (Money!)

The sum of all the prices of all the items in the order, taxes and discounts included (must be positive).

Required access

unauthenticated_read_ access scope

totalRefunded   (Money!)

The total amount that has been refunded.

Required access

unauthenticated_read_ access scope

totalShippingPrice   (Money!)

The total cost of shipping.

Required access

unauthenticated_read_ access scope

totalTax   (Money)

The total cost of taxes.

Required access

unauthenticated_read_ access scope

Sign up for a Partner account to get started.

Sign up