--- 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: 2025-10 api_name: customer type: object api_type: graphql 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 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 * 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. * 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[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/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. * 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[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/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). *** ## \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)