--- title: DraftOrder - Customer API description: |- A draft order for the customer. Any fields related to money are in the presentment currency. 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-10 source_url: html: https://shopify.dev/docs/api/customer/latest/objects/draftorder md: https://shopify.dev/docs/api/customer/latest/objects/draftorder.md --- # Draft​Order object Requires `customer_read_draft_orders` access scope. A draft order for the customer. Any fields related to money are in the presentment currency. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data). ## Fields * amount​Due​Later [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) non-null The amount due later. When there are payment terms, this is the total price minus the deposit amount (if any). When there are no payment terms, this is 0. * amount​Due​Now [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) non-null The amount due now. When there are payment terms this is the value of the deposit (0 by default). When there are no payment terms, this is the total price. * billing​Address [Customer​Address](https://shopify.dev/docs/api/customer/latest/objects/CustomerAddress) The billing address of the customer. * created​At [Date​Time!](https://shopify.dev/docs/api/customer/latest/scalars/DateTime) non-null The date and time when the draft order was created in Shopify. * currency​Code [Currency​Code!](https://shopify.dev/docs/api/customer/latest/enums/CurrencyCode) non-null The three-letter code for the currency of the store at the time that the invoice is sent. * customer [Customer](https://shopify.dev/docs/api/customer/latest/objects/Customer) The customer who placed the order. * deposit [Deposit​Configuration](https://shopify.dev/docs/api/customer/latest/unions/DepositConfiguration) The portion required to be paid at checkout. * discount​Applications [Discount​Application​Connection!](https://shopify.dev/docs/api/customer/latest/connections/DiscountApplicationConnection) non-null List of discounts applied to the draft order. * after [String](https://shopify.dev/docs/api/customer/latest/scalars/String) ### Arguments The elements that come after the specified [cursor](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). * first [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The first `n` elements from the [paginated list](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). * reverse [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) Default:false Reverse the order of the underlying list. *** * discount​Information [Draft​Order​Discount​Information!](https://shopify.dev/docs/api/customer/latest/objects/DraftOrderDiscountInformation) non-null The discount information for the draft order. * email [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The email address of the customer, which is used to send notifications to. * id [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID) non-null A globally-unique ID. * in​Review [Boolean!](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) non-null Whether the draft order is created from the online store and is open. * invoice​Url [URL](https://shopify.dev/docs/api/customer/latest/scalars/URL) The link to the checkout, which is sent to the customer in the invoice email. * line​Items [Draft​Order​Line​Item​Connection!](https://shopify.dev/docs/api/customer/latest/connections/DraftOrderLineItemConnection) non-null The list of the line items in the draft order. * after [String](https://shopify.dev/docs/api/customer/latest/scalars/String) ### Arguments The elements that come after the specified [cursor](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). * first [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * flatten​Components [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) Default:false Whether to flatten components into the line items list. When true, returns both parent and component line items as top-level nodes. When false, returns only parent line items as top-level nodes.For API versions before 2026-04, defaults to true. For API versions 2026-04 and later, defaults to false. * 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). * reverse [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) Default:false Reverse the order of the underlying list. *** * line​Items​Summary [Draft​Order​Line​Items​Summary](https://shopify.dev/docs/api/customer/latest/objects/DraftOrderLineItemsSummary) The summary of draft order line items quantity. * name [String!](https://shopify.dev/docs/api/customer/latest/scalars/String) non-null The unique identifier for the draft order, which is unique within the store. For example, *#D1223*. * order [Order](https://shopify.dev/docs/api/customer/latest/objects/Order) The order that was created from this draft order. * phone [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The phone number assigned to the draft order. * purchasing​Entity [Purchasing​Entity](https://shopify.dev/docs/api/customer/latest/unions/PurchasingEntity) The purchasing entity for the draft order. * requires​Shipping [Boolean!](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) non-null Whether the draft order requires shipping or not. * shipping​Address [Customer​Address](https://shopify.dev/docs/api/customer/latest/objects/CustomerAddress) The shipping address of the customer. * status [Draft​Order​Status!](https://shopify.dev/docs/api/customer/latest/enums/DraftOrderStatus) non-null The status of the draft order. * subtotal​Price [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) non-null The subtotal of the line items (doesn't include shipping charges, shipping discounts, or taxes). * taxes​Included [Boolean!](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) non-null Whether the line item prices include taxes. * tax​Exempt [Boolean!](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) non-null Indicates whether the draft order is tax exempt. * total​Line​Items​Price [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) non-null The total price of line items for this draft order. * total​Price [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) non-null The total amount of the draft order (includes taxes, shipping charges, and discounts). * total​Shipping​Price [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) non-null The total shipping charge for the draft order. * total​Tax [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) non-null The total amount of taxes for the draft order. * total​Weight [Unsigned​Int64!](https://shopify.dev/docs/api/customer/latest/scalars/UnsignedInt64) non-null The total weight (in grams) of the draft order. * updated​At [Date​Time!](https://shopify.dev/docs/api/customer/latest/scalars/DateTime) non-null The date and time when the draft order was last changed. The format is YYYY-MM-DD HH:mm:ss (for example, 2016-02-05 17:04:01). *** ## Map ### Fields and connections with this object * [Company.draftOrders](https://shopify.dev/docs/api/customer/latest/objects/Company#field-Company.fields.draftOrders) * [CompanyContact.draftOrders](https://shopify.dev/docs/api/customer/latest/objects/CompanyContact#field-CompanyContact.fields.draftOrders) * [CompanyLocation.draftOrders](https://shopify.dev/docs/api/customer/latest/objects/CompanyLocation#field-CompanyLocation.fields.draftOrders) * [Customer.draftOrders](https://shopify.dev/docs/api/customer/latest/objects/Customer#field-Customer.fields.draftOrders) * [DraftOrderConnection.nodes](https://shopify.dev/docs/api/customer/latest/connections/DraftOrderConnection#returns-nodes) * [DraftOrderEdge.node](https://shopify.dev/docs/api/customer/latest/objects/DraftOrderEdge#field-DraftOrderEdge.fields.node) * [Order.draftOrder](https://shopify.dev/docs/api/customer/latest/objects/Order#field-Order.fields.draftOrder) *** ## Queries * [draft​Order](https://shopify.dev/docs/api/customer/latest/queries/draftOrder) query Returns a draft order resource by ID. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data). * id [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID) required ### Arguments The ID of the draft order to be returned. *** *** ## DraftOrder Queries ### Queried by * [draft​Order](https://shopify.dev/docs/api/customer/latest/queries/draftOrder) *** ## Interfaces * [Node](https://shopify.dev/docs/api/customer/latest/interfaces/Node) interface *** ## DraftOrder Implements ### Implements * [Node](https://shopify.dev/docs/api/customer/latest/interfaces/Node)