# Cart

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

## Type Definition

```graphql
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

```graphql
{
  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

## Related Types

- [Customer](/reference/storefront/1.3.0/objects/customer)
- [CartDiscount](/reference/storefront/1.3.0/objects/cart-discount)
- [CartTaxLine](/reference/storefront/1.3.0/objects/cart-tax-line)
- [CartPaymentMethod](/reference/storefront/1.3.0/objects/cart-payment-method)
- [CartShippingMethod](/reference/storefront/1.3.0/objects/cart-shipping-method)
- [CartLineItem](/reference/storefront/1.3.0/objects/cart-line-item)
- [Address](/reference/storefront/1.3.0/objects/address)
- [Metafield](/reference/storefront/1.3.0/objects/metafield)