---
title: Checkout - Customer API
description: A container for information required to checkout items and pay. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).
api_version: 2025-10
api_name: customer
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/objects/checkout
  md: https://shopify.dev/docs/api/customer/latest/objects/checkout.md
---

# Checkout

object

A container for information required to checkout items and pay. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).

## Fields

* applied​Gift​Cards

  [\[Applied​Gift​Card!\]!](https://shopify.dev/docs/api/customer/latest/objects/AppliedGiftCard)

  non-null

  The gift cards used on the checkout.

* available​Shipping​Rates

  [Available​Shipping​Rates](https://shopify.dev/docs/api/customer/latest/objects/AvailableShippingRates)

  The available shipping rates for this Checkout. Should only be used when checkout `requiresShipping` is `true` and the shipping address is valid.

* created​At

  [Date​Time!](https://shopify.dev/docs/api/customer/latest/scalars/DateTime)

  non-null

  The date and time when the checkout was created.

* currency​Code

  [Currency​Code!](https://shopify.dev/docs/api/customer/latest/enums/CurrencyCode)

  non-null

  The currency code for the checkout.

* custom​Attributes

  [\[Attribute!\]!](https://shopify.dev/docs/api/customer/latest/objects/Attribute)

  non-null

  The extra information added to the checkout.

* discount​Applications

  [Discount​Application​Connection!](https://shopify.dev/docs/api/customer/latest/connections/DiscountApplicationConnection)

  non-null

  The discounts applied on the checkout.

* email

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The email associated with this checkout.

* id

  [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  A globally-unique ID.

* line​Items

  [Checkout​Line​Item​Connection!](https://shopify.dev/docs/api/customer/latest/connections/CheckoutLineItemConnection)

  non-null

  A list of line item objects, each containing information about an item in the checkout.

* line​Items​Subtotal​Price

  [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

  non-null

  The sum of all the prices of all the items in the checkout, excluding duties, taxes, shipping, and discounts.

* note

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The note associated with the checkout.

* payment​Due

  [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

  non-null

  The amount left to be paid. This is equal to the cost of the line items, duties, taxes, and shipping, minus discounts and gift cards.

* ready

  [Boolean!](https://shopify.dev/docs/api/customer/latest/scalars/Boolean)

  non-null

  Whether the Checkout is ready and can be completed. Checkouts may have asynchronous operations that can take time to finish. If you want to complete a checkout or ensure all the fields are populated and up to date, polling is required until the value is true.

* requires​Shipping

  [Boolean!](https://shopify.dev/docs/api/customer/latest/scalars/Boolean)

  non-null

  Whether the fulfillment requires shipping.

* shipping​Discount​Allocations

  [\[Discount​Allocation!\]!](https://shopify.dev/docs/api/customer/latest/objects/DiscountAllocation)

  non-null

  The discounts allocated to the shipping line by discount applications.

* shipping​Line

  [Shipping​Rate](https://shopify.dev/docs/api/customer/latest/objects/ShippingRate)

  The selected shipping rate, transitioned to a `shipping_line` object.

* subtotal​Price

  [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

  non-null

  The price at checkout before duties, shipping, and taxes.

* taxes​Included

  [Boolean!](https://shopify.dev/docs/api/customer/latest/scalars/Boolean)

  non-null

  Whether taxes are included in the line item and shipping line prices.

* tax​Exempt

  [Boolean!](https://shopify.dev/docs/api/customer/latest/scalars/Boolean)

  non-null

  Whether the checkout is tax exempt.

* total​Duties

  [Money​V2](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

  The sum of all the duties applied to the line items in the checkout.

* total​Price

  [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

  non-null

  The sum of all the prices of all the items in the checkout, duties, taxes, and discounts included.

* total​Tax

  [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

  non-null

  The sum of all the taxes applied to the line items and shipping lines in the checkout.

* web​Url

  [URL!](https://shopify.dev/docs/api/customer/latest/scalars/URL)

  non-null

  The URL for the checkout, accessible from the web.

***

## Map

### Fields with this object

* {}[Customer.lastIncompleteCheckout](https://shopify.dev/docs/api/customer/latest/objects/Customer#field-lastIncompleteCheckout)

***

## Interfaces

* [Node](https://shopify.dev/docs/api/customer/latest/interfaces/Node)

  interface

***

## ||-Checkout Implements

### Implements

* ||-[Node](https://shopify.dev/docs/api/customer/latest/interfaces/Node)