# Checkout - storefront - OBJECT Version: 2024-04 ## Description A container for all the information required to checkout items and pay. The Storefront GraphQL Checkout API is deprecated and will be removed in a future version. Please see https://shopify.dev/changelog/deprecation-of-checkout-apis for more information. ### Access Scopes `unauthenticated_read_checkouts` access scope. ## Fields * [appliedGiftCards](/docs/api/storefront/2024-04/objects/AppliedGiftCard): AppliedGiftCard! - The gift cards used on the checkout. * [availableShippingRates](/docs/api/storefront/2024-04/objects/AvailableShippingRates): AvailableShippingRates - The available shipping rates for this Checkout. Should only be used when checkout `requiresShipping` is `true` and the shipping address is valid. * [buyerIdentity](/docs/api/storefront/2024-04/objects/CheckoutBuyerIdentity): CheckoutBuyerIdentity! - The identity of the customer associated with the checkout. * [completedAt](/docs/api/storefront/2024-04/scalars/DateTime): DateTime - The date and time when the checkout was completed. * [createdAt](/docs/api/storefront/2024-04/scalars/DateTime): DateTime! - The date and time when the checkout was created. * [currencyCode](/docs/api/storefront/2024-04/enums/CurrencyCode): CurrencyCode! - The currency code for the checkout. * [customAttributes](/docs/api/storefront/2024-04/objects/Attribute): Attribute! - A list of extra information that's added to the checkout. * [email](/docs/api/storefront/2024-04/scalars/String): String - The email attached to this checkout. * [id](/docs/api/storefront/2024-04/scalars/ID): ID! - A globally-unique ID. * [lineItemsSubtotalPrice](/docs/api/storefront/2024-04/objects/MoneyV2): MoneyV2! - The sum of all the prices of all the items in the checkout. Duties, taxes, shipping and discounts excluded. * [note](/docs/api/storefront/2024-04/scalars/String): String - The note associated with the checkout. * [order](/docs/api/storefront/2024-04/objects/Order): Order - The resulting order from a paid checkout. * [orderStatusUrl](/docs/api/storefront/2024-04/scalars/URL): URL - The Order status page for this Checkout, null when checkout isn't completed. * [paymentDue](/docs/api/storefront/2024-04/objects/MoneyV2): MoneyV2! - The amount left to be paid. This is equal to the cost of the line items, taxes, and shipping, minus discounts and gift cards. * [paymentDueV2](/docs/api/storefront/2024-04/objects/MoneyV2): MoneyV2! - 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](/docs/api/storefront/2024-04/scalars/Boolean): Boolean! - Whether or not 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. * [requiresShipping](/docs/api/storefront/2024-04/scalars/Boolean): Boolean! - States whether or not the fulfillment requires shipping. * [shippingAddress](/docs/api/storefront/2024-04/objects/MailingAddress): MailingAddress - The shipping address to where the line items will be shipped. * [shippingDiscountAllocations](/docs/api/storefront/2024-04/objects/DiscountAllocation): DiscountAllocation! - The discounts that have been allocated onto the shipping line by discount applications. * [shippingLine](/docs/api/storefront/2024-04/objects/ShippingRate): ShippingRate - Once a shipping rate is selected by the customer it's transitioned to a `shipping_line` object. * [subtotalPrice](/docs/api/storefront/2024-04/objects/MoneyV2): MoneyV2! - The price at checkout before shipping and taxes. * [subtotalPriceV2](/docs/api/storefront/2024-04/objects/MoneyV2): MoneyV2! - The price at checkout before duties, shipping, and taxes. * [taxExempt](/docs/api/storefront/2024-04/scalars/Boolean): Boolean! - Whether the checkout is tax exempt. * [taxesIncluded](/docs/api/storefront/2024-04/scalars/Boolean): Boolean! - Whether taxes are included in the line item and shipping line prices. * [totalDuties](/docs/api/storefront/2024-04/objects/MoneyV2): MoneyV2 - The sum of all the duties applied to the line items in the checkout. * [totalPrice](/docs/api/storefront/2024-04/objects/MoneyV2): MoneyV2! - The sum of all the prices of all the items in the checkout, including taxes and duties. * [totalPriceV2](/docs/api/storefront/2024-04/objects/MoneyV2): MoneyV2! - The sum of all the prices of all the items in the checkout, including taxes and duties. * [totalTax](/docs/api/storefront/2024-04/objects/MoneyV2): MoneyV2! - The sum of all the taxes applied to the line items and shipping lines in the checkout. * [totalTaxV2](/docs/api/storefront/2024-04/objects/MoneyV2): MoneyV2! - The sum of all the taxes applied to the line items and shipping lines in the checkout. * [updatedAt](/docs/api/storefront/2024-04/scalars/DateTime): DateTime! - The date and time when the checkout was last updated. * [webUrl](/docs/api/storefront/2024-04/scalars/URL): URL! - The url pointing to the checkout accessible from the web. ## Connections * [discountApplications](/docs/api/storefront/2024-04/connections/DiscountApplicationConnection): DiscountApplicationConnection! * [lineItems](/docs/api/storefront/2024-04/connections/CheckoutLineItemConnection): CheckoutLineItemConnection! ## Related queries ## Related mutations * [checkoutAttributesUpdateV2](/docs/api/storefront/2024-04/mutations/checkoutAttributesUpdateV2) Updates the attributes of a checkout if `allowPartialAddresses` is `true`. * [checkoutCompleteFree](/docs/api/storefront/2024-04/mutations/checkoutCompleteFree) Completes a checkout without providing payment information. You can use this mutation for free items or items whose purchase price is covered by a gift card. * [checkoutCompleteWithCreditCardV2](/docs/api/storefront/2024-04/mutations/checkoutCompleteWithCreditCardV2) Completes a checkout using a credit card token from Shopify's card vault. Before you can complete checkouts using CheckoutCompleteWithCreditCardV2, you need to [_request payment processing_](https://shopify.dev/apps/channels/getting-started#request-payment-processing). * [checkoutCompleteWithTokenizedPaymentV3](/docs/api/storefront/2024-04/mutations/checkoutCompleteWithTokenizedPaymentV3) Completes a checkout with a tokenized payment. * [checkoutCreate](/docs/api/storefront/2024-04/mutations/checkoutCreate) Creates a new checkout. * [checkoutCustomerAssociateV2](/docs/api/storefront/2024-04/mutations/checkoutCustomerAssociateV2) Associates a customer to the checkout. * [checkoutCustomerDisassociateV2](/docs/api/storefront/2024-04/mutations/checkoutCustomerDisassociateV2) Disassociates the current checkout customer from the checkout. * [checkoutDiscountCodeApplyV2](/docs/api/storefront/2024-04/mutations/checkoutDiscountCodeApplyV2) Applies a discount to an existing checkout using a discount code. * [checkoutDiscountCodeRemove](/docs/api/storefront/2024-04/mutations/checkoutDiscountCodeRemove) Removes the applied discounts from an existing checkout. * [checkoutEmailUpdateV2](/docs/api/storefront/2024-04/mutations/checkoutEmailUpdateV2) Updates the email on an existing checkout. * [checkoutGiftCardRemoveV2](/docs/api/storefront/2024-04/mutations/checkoutGiftCardRemoveV2) Removes an applied gift card from the checkout. * [checkoutGiftCardsAppend](/docs/api/storefront/2024-04/mutations/checkoutGiftCardsAppend) Appends gift cards to an existing checkout. * [checkoutLineItemsAdd](/docs/api/storefront/2024-04/mutations/checkoutLineItemsAdd) Adds a list of line items to a checkout. * [checkoutLineItemsRemove](/docs/api/storefront/2024-04/mutations/checkoutLineItemsRemove) Removes line items from an existing checkout. * [checkoutLineItemsReplace](/docs/api/storefront/2024-04/mutations/checkoutLineItemsReplace) Sets a list of line items to a checkout. * [checkoutLineItemsUpdate](/docs/api/storefront/2024-04/mutations/checkoutLineItemsUpdate) Updates line items on a checkout. * [checkoutShippingAddressUpdateV2](/docs/api/storefront/2024-04/mutations/checkoutShippingAddressUpdateV2) Updates the shipping address of an existing checkout. * [checkoutShippingLineUpdate](/docs/api/storefront/2024-04/mutations/checkoutShippingLineUpdate) Updates the shipping lines on an existing checkout. ## Related Unions ## Examples