--- 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: 2026-01 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. * first [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) ### Arguments The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * after [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * reverse [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) Default:false Reverse the order of the underlying list. *** * 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 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. * first [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) ### Arguments The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * after [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * reverse [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) Default:false Reverse the order of the underlying list. *** * 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-Customer.fields.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)