--- 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-04 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. * flatten​Components [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) Default:false ### Arguments 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. * 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). * 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​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). * 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)