--- 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: unstable api_name: customer source_url: html: 'https://shopify.dev/docs/api/customer/unstable/objects/DraftOrder' md: 'https://shopify.dev/docs/api/customer/unstable/objects/DraftOrder.md' --- # Draft​Order object 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/unstable/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/unstable/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/unstable/objects/CustomerAddress) The billing address of the customer. * created​At [Date​Time!](https://shopify.dev/docs/api/customer/unstable/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/unstable/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/unstable/objects/Customer) The customer who placed the order. * deposit [Deposit​Configuration](https://shopify.dev/docs/api/customer/unstable/unions/DepositConfiguration) The portion required to be paid at checkout. * discount​Information [Draft​Order​Discount​Information!](https://shopify.dev/docs/api/customer/unstable/objects/DraftOrderDiscountInformation) non-null The discount information for the draft order. * email [String](https://shopify.dev/docs/api/customer/unstable/scalars/String) The email address of the customer, which is used to send notifications to. * id [ID!](https://shopify.dev/docs/api/customer/unstable/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. * in​Review [Boolean!](https://shopify.dev/docs/api/customer/unstable/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/unstable/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/unstable/connections/DraftOrderLineItemConnection) non-null The list of the line items in the draft order. * line​Items​Summary [Draft​Order​Line​Items​Summary](https://shopify.dev/docs/api/customer/unstable/objects/DraftOrderLineItemsSummary) The summary of draft order line items quantity. * name [String!](https://shopify.dev/docs/api/customer/unstable/scalars/String) non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api) The unique identifier for the draft order, which is unique within the store. For example, *#D1223*. * order [Order](https://shopify.dev/docs/api/customer/unstable/objects/Order) The order that was created from this draft order. * phone [String](https://shopify.dev/docs/api/customer/unstable/scalars/String) The phone number assigned to the draft order. * purchasing​Entity [Purchasing​Entity](https://shopify.dev/docs/api/customer/unstable/unions/PurchasingEntity) The purchasing entity for the draft order. * requires​Shipping [Boolean!](https://shopify.dev/docs/api/customer/unstable/scalars/Boolean) non-null Whether the draft order requires shipping or not. * shipping​Address [Customer​Address](https://shopify.dev/docs/api/customer/unstable/objects/CustomerAddress) The shipping address of the customer. * status [Draft​Order​Status!](https://shopify.dev/docs/api/customer/unstable/enums/DraftOrderStatus) non-null The status of the draft order. * subtotal​Price [Money​V2!](https://shopify.dev/docs/api/customer/unstable/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/unstable/scalars/Boolean) non-null Whether the line item prices include taxes. * tax​Exempt [Boolean!](https://shopify.dev/docs/api/customer/unstable/scalars/Boolean) non-null Indicates whether the draft order is tax exempt. * total​Line​Items​Price [Money​V2!](https://shopify.dev/docs/api/customer/unstable/objects/MoneyV2) non-null The total price of line items for this draft order. * total​Price [Money​V2!](https://shopify.dev/docs/api/customer/unstable/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/unstable/objects/MoneyV2) non-null The total shipping charge for the draft order. * total​Tax [Money​V2!](https://shopify.dev/docs/api/customer/unstable/objects/MoneyV2) non-null The total amount of taxes for the draft order. * total​Weight [Unsigned​Int64!](https://shopify.dev/docs/api/customer/unstable/scalars/UnsignedInt64) non-null The total weight (in grams) of the draft order. * updated​At [Date​Time!](https://shopify.dev/docs/api/customer/unstable/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/unstable/objects/Company#field-Company.fields.draftOrders) * {}[CompanyContact.draftOrders](https://shopify.dev/docs/api/customer/unstable/objects/CompanyContact#field-CompanyContact.fields.draftOrders) * {}[CompanyLocation.draftOrders](https://shopify.dev/docs/api/customer/unstable/objects/CompanyLocation#field-CompanyLocation.fields.draftOrders) * {}[Customer.draftOrders](https://shopify.dev/docs/api/customer/unstable/objects/Customer#field-Customer.fields.draftOrders) * <->[DraftOrderConnection.nodes](https://shopify.dev/docs/api/customer/unstable/connections/DraftOrderConnection#returns-nodes) * {}[DraftOrderEdge.node](https://shopify.dev/docs/api/customer/unstable/objects/DraftOrderEdge#field-DraftOrderEdge.fields.node) * {}[Order.draftOrder](https://shopify.dev/docs/api/customer/unstable/objects/Order#field-Order.fields.draftOrder) *** ## Queries * [draft​Order](https://shopify.dev/docs/api/customer/unstable/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). *** ## \DraftOrder Queries ### Queried by * \[draft​Order](https://shopify.dev/docs/api/customer/unstable/queries/draftOrder) *** ## Interfaces * [Node](https://shopify.dev/docs/api/customer/unstable/interfaces/Node) interface *** ## ||-DraftOrder Implements ### Implements * ||-[Node](https://shopify.dev/docs/api/customer/unstable/interfaces/Node)