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
}

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.

Relationships

The Cart type relates to several other types in the schema. It maintains a reference to a Customer if a customer is linked to the cart. It contains collections of CartDiscount objects representing applied discounts, CartTaxLine objects for tax calculations, CartPaymentMethod objects for available payment options, CartShippingMethod objects for shipping choices, and CartLineItem objects representing the items in the cart. Shipping and billing information is provided through Address objects.

Example


query GetCart {
  cart(id: "eyJhbGciOiJIUzI1NiJ9...") {
    id
    createdAt
    totalPrice
    currency
    subtotalPrice
    totalTax
    shippingPrice
    lineCount
    customer {
      id
      email
    }
    lines {
      id
      quantity
    }
    discounts {
      code
      amount
    }
    shippingAddress {
      city
      country
    }
    checkoutUrl
  }
}

Implements

This type does not implement any interfaces.