---
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-10
api_name: customer
type: query
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/queries/DraftOrder
  md: https://shopify.dev/docs/api/customer/latest/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/latest/scalars/ID)

  required

  The ID of the draft order to be returned.

***

## Possible returns

* Draft​Order

  [Draft​Order](https://shopify.dev/docs/api/customer/latest/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/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.

    * first

      [Int](https://shopify.dev/docs/api/customer/latest/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/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).

***

## Examples

* ### draftOrder reference

## Query Reference

```graphql
{
  draftOrder(id) {
    # draftOrder fields
  }
}
```