--- title: draftOrder - Customer API description: >- 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). api_version: 2025-07 api_name: customer type: query api_type: graphql source_url: html: 'https://shopify.dev/docs/api/customer/2025-07/queries/draftOrder' md: 'https://shopify.dev/docs/api/customer/2025-07/queries/draftOrder.md' --- # draft​Order 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). ## Arguments * id [ID!](https://shopify.dev/docs/api/customer/2025-07/scalars/ID) required The ID of the draft order to be returned. *** ## Possible returns * Draft​Order [Draft​Order](https://shopify.dev/docs/api/customer/2025-07/objects/DraftOrder) 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). * billing​Address [Customer​Address](https://shopify.dev/docs/api/customer/2025-07/objects/CustomerAddress) The billing address of the customer. * created​At [Date​Time!](https://shopify.dev/docs/api/customer/2025-07/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/2025-07/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/2025-07/objects/Customer) The customer who placed the order. * discount​Information [Draft​Order​Discount​Information!](https://shopify.dev/docs/api/customer/2025-07/objects/DraftOrderDiscountInformation) non-null The discount information for the draft order. * email [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) The email address of the customer, which is used to send notifications to. * id [ID!](https://shopify.dev/docs/api/customer/2025-07/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/2025-07/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/2025-07/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/2025-07/connections/DraftOrderLineItemConnection) non-null The list of the line items in the draft order. * first [Int](https://shopify.dev/docs/api/customer/2025-07/scalars/Int) ### Arguments The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * after [String](https://shopify.dev/docs/api/customer/2025-07/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/2025-07/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/2025-07/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/2025-07/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/2025-07/objects/DraftOrderLineItemsSummary) The summary of draft order line items quantity. * name [String!](https://shopify.dev/docs/api/customer/2025-07/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/2025-07/objects/Order) The order that was created from this draft order. * phone [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String) The phone number assigned to the draft order. * purchasing​Entity [Purchasing​Entity](https://shopify.dev/docs/api/customer/2025-07/unions/PurchasingEntity) The purchasing entity for the draft order. * requires​Shipping [Boolean!](https://shopify.dev/docs/api/customer/2025-07/scalars/Boolean) non-null Whether the draft order requires shipping or not. * shipping​Address [Customer​Address](https://shopify.dev/docs/api/customer/2025-07/objects/CustomerAddress) The shipping address of the customer. * status [Draft​Order​Status!](https://shopify.dev/docs/api/customer/2025-07/enums/DraftOrderStatus) non-null The status of the draft order. * subtotal​Price [Money​V2!](https://shopify.dev/docs/api/customer/2025-07/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/2025-07/scalars/Boolean) non-null Whether the line item prices include taxes. * tax​Exempt [Boolean!](https://shopify.dev/docs/api/customer/2025-07/scalars/Boolean) non-null Indicates whether the draft order is tax exempt. * total​Line​Items​Price [Money​V2!](https://shopify.dev/docs/api/customer/2025-07/objects/MoneyV2) non-null The total price of line items for this draft order. * total​Price [Money​V2!](https://shopify.dev/docs/api/customer/2025-07/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/2025-07/objects/MoneyV2) non-null The total shipping charge for the draft order. * total​Tax [Money​V2!](https://shopify.dev/docs/api/customer/2025-07/objects/MoneyV2) non-null The total amount of taxes for the draft order. * total​Weight [Unsigned​Int64!](https://shopify.dev/docs/api/customer/2025-07/scalars/UnsignedInt64) non-null The total weight (in grams) of the draft order. * updated​At [Date​Time!](https://shopify.dev/docs/api/customer/2025-07/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). *** ## Examples * ### draftOrder reference