Cart

Represents a cart in the store, exposing totals, items, discounts, shipping, and payment information for GraphQL APIs.

Type Definition


type Cart {
  id: String
  createdAt: String
  confirmedAt: String
  fulfilledAt: String
  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
  checkoutUrl: String
  metafields: [Metafield]!
  metafield: Metafield
}

Fields

Field	Type	Description
id	String	Returns the id for this cart.
createdAt	String	Date when this order was created in RFC 2822 format.
confirmedAt	String	Date when this order was confirmed in RFC 2822 format.
fulfilledAt	String	Date when this order was fulfilled in RFC 2822 format.
customer	Customer	Customer linked to this order if any.
discounts	[CartDiscount]	Return the discounts applied to this cart.
tags	[String]	Returns the tags associated with this cart.
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 cart.
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 cart.
customerNote	String	Returns the customer note.
paymentMethods	[CartPaymentMethod]	Returns the payment methods for this cart.
paymentFee	Float	Returns the total payment fee in customer’s currency.
shippingMethods	[CartShippingMethod]	Returns the shipping methods for this cart.
shippingPrice	Float	Returns the total shipping costs in customer’s currency.
lines	[CartLineItem]	Returns the items in this cart.
physicalLines	[CartLineItem]	Returns the physical items in this cart.
lineCount	Int	Returns the number of items in this cart.
shippingAddress	Address	Returns the shipping address for this cart.
billingAddress	Address	Returns the billing address for this cart.
checkoutUrl	String	Returns the checkout URL for this cart.
metafields	[Metafield]!	Metafields stored on this resource.
metafield	Metafield	A single metafield by namespace and key.

Relationships

The Cart type represents a collection of items a customer intends to purchase. It relates to multiple types across the system: it references a Customer who owns the cart, contains CartLineItem entries for each product, applies CartDiscount entries for promotional pricing, includes CartTaxLine entries for tax calculations, tracks CartPaymentMethod and CartShippingMethod options, stores shipping and billing Address information, and maintains custom metadata through Metafield entries. This type serves as a central hub connecting customer identity, product selection, pricing, and fulfillment details.

Example


{
  cart(id: "eyJhbGciOiJIUzI1NiJ9...") {
    id
    createdAt
    confirmedAt
    totalPrice
    currency
    subtotalPrice
    totalTax
    shippingPrice
    lineCount
    customer {
      id
    }
    lines {
      id
    }
    discounts {
      id
    }
    shippingAddress {
      id
    }
    billingAddress {
      id
    }
    checkoutUrl
  }
}

Implements

None