---
title: DraftOrder
description: Allow merchants to manually create orders on behalf of customers. The order is saved as a draft in the Shopify admin until it's marked as completed.
api_version: 2025-10
api_name: admin-rest
api_type: rest
source_url:
html: https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder
md: https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder.md
---

The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the [GraphQL Admin API](https://shopify.dev/docs/api/admin-graphql). For details and migration steps, visit our [migration guide](https://shopify.dev/docs/apps/build/graphql/migrate).
# DraftOrder
Requires `draft_orders` access scope.
Requires access to [protected customer data](https://shopify.dev/apps/store/data-protection/protected-customer-data).
Merchants can use draft orders to create orders on behalf of their customers. Draft orders are useful for merchants that need to do the following tasks:
* Create new orders for sales made by phone, in person, by chat, or elsewhere. When a merchant accepts payment for a draft order, an order is created.
* Send invoices to customers to pay with a secure checkout link.
* Use custom items to represent additional costs or products that aren't displayed in a shop's inventory.
* Re-create orders manually from active sales channels.
* Sell products at discount or wholesale rates.
* Take pre-orders.
Note
The Draft Order resource doesn't expose reserve inventory information.
**Caution:** Only use this data if it is necessary for the intended app functionality. Shopify retains the ability to restrict access to [API Access scopes](https://shopify.dev/api/usage/access-scopes) for apps not requiring legitimate use of the associated data.
\#
## Endpoints
* [post](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#post-draft-orders)
[/admin/api/latest/draft\_orders.json](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#post-draft-orders)
Create a new DraftOrder
[](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderCreate)
[draftOrderCreate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderCreate)
* [post](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#post-draft-orders-draft-order-id-send-invoice)
[/admin/api/latest/draft\_orders/{draft\_order\_id}/send\_invoice.json](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#post-draft-orders-draft-order-id-send-invoice)
Send an invoice
[](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderInvoiceSend?example=send-an-invoice)
[draftOrderInvoiceSend](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderInvoiceSend?example=send-an-invoice)
* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#get-draft-orders)
[/admin/api/latest/draft\_orders.json](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#get-draft-orders)
Retrieves a list of draft orders
[](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrders?example=retrieves-a-list-of-draft-orders)
[draftOrders](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrders?example=retrieves-a-list-of-draft-orders)
* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#get-draft-orders-draft-order-id)
[/admin/api/latest/draft\_orders/{draft\_order\_id}.json](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#get-draft-orders-draft-order-id)
Receive a single DraftOrder
[](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrder?example=receive-a-single-draftorder)
[draftOrder](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrder?example=receive-a-single-draftorder)
* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#get-draft-orders-count)
[/admin/api/latest/draft\_orders/count.json](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#get-draft-orders-count)
Receive a count of all DraftOrders
[](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrdersCount)
[draftOrdersCount](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrdersCount)
* [put](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#put-draft-orders-draft-order-id)
[/admin/api/latest/draft\_orders/{draft\_order\_id}.json](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#put-draft-orders-draft-order-id)
Modify an existing DraftOrder
[](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderUpdate?example=modify-an-existing-draftorder)
[draftOrderUpdate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderUpdate?example=modify-an-existing-draftorder)
* [put](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#put-draft-orders-draft-order-id-complete)
[/admin/api/latest/draft\_orders/{draft\_order\_id}/complete.json](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#put-draft-orders-draft-order-id-complete)
Complete a draft order
[](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderComplete?example=complete-a-draft-order)
[draftOrderComplete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderComplete?example=complete-a-draft-order)
* [del](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#delete-draft-orders-draft-order-id)
[/admin/api/latest/draft\_orders/{draft\_order\_id}.json](https://shopify.dev/docs/api/admin-rest/latest/resources/draftorder#delete-draft-orders-draft-order-id)
Remove an existing DraftOrder
[](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderDelete?example=remove-an-existing-draftorder)
[draftOrderDelete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderDelete?example=remove-an-existing-draftorder)
***
## The DraftOrder resource
### Properties
***
id
read-only
->
[](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.id)
[id](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.id)
The ID of the draft order.
***
order\_id
read-only
->
[](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.id)
[id](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.id)
The ID of the order that's created and associated with the draft order after the draft order is completed.
***
name
read-only
->
[](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.name)
[name](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.name)
Name of the draft order.
***
customer
->
[](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.customer)
[customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.customer)
The customer resource, which contains information about the customer. Learn more about [loading and removing customers](#loading-and-removing-customers). For more information about the `customer` resource, see the [Customer](https://shopify.dev/api/admin-rest/current/resources/customer) documentation.
***
shipping\_address
->
[](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.shippingAddress)
[shippingAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.shippingAddress)
The address to ship the order to. The `shipping_address` is optional and will not be available on orders that don't require shipping. The `shipping_address` resource has the following properties:
Show shipping\_address properties
* **address1**: The street address of the shipping address.
* **address2**: An optional additional field for the street address of the shipping address.
* **city**: The city of the shipping address.
* **company**: The company of the person associated with the shipping address.
* **country**: The name of the country of the shipping address.
* **country\_code**: The two-letter code for the country of the shipping address.
* **first\_name**: The first name of the person associated with the payment method.
* **last\_name**: The last name of the person associated with the payment method.
* **latitude**: The latitude of the shipping address.
* **longitude**: The longitude of the shipping address.
* **name**: The full name of the person associated with the payment method.
* **phone**: The phone number at the shipping address.
* **province**: The name of the state or province of the shipping address.
* **province\_code**: The alphanumeric abbreviation of the state or province of the shipping address.
* **zip**: The zip or postal code of the shipping address.
***
billing\_address
->
[](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.billingAddress)
[billingAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.billingAddress)
The mailing address associated with the payment method. This address is an optional field that won't be available on orders that do not require a payment method. The `billing_address` resource has the following properties:
Show billing\_address properties
* **address1**: The street address of the billing address.
* **address2**: An optional additional field for the street address of the billing address.
* **city**: The city of the billing address.
* **company**: The company of the person associated with the billing address.
* **country**: The name of the country of the billing address.
* **country\_code**: The two-letter code ([ISO 3166-1 alpha-2 two-letter country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)) for the country of the billing address.
* **first\_name**: The first name of the person associated with the payment method.
* **last\_name**: The last name of the person associated with the payment method.
* **latitude**: The latitude of the billing address.
* **longitude**: The longitude of the billing address.
* **name**: The full name of the person associated with the payment method.
* **phone**: The phone number at the billing address.
* **province**: The name of the billing address region, such as province, state, or prefecture.
* **province\_code**: The alphanumeric abbreviation of the region for the billing address.
* **zip**: The postal code of the billing address, such as zip, postcode, or Eircode.
***
note
->
[](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.note2)
[note2](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.note2)
The text of an optional note that a merchant can attach to the draft order.
***
note\_attributes
->
[](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.customAttributes)
[customAttributes](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.customAttributes)
The extra information that's added to the order. The information appears in the**Additional details** section of an order details page. Each array entry must contain a hash with `name` and `value` keys.
***
email
->
[](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.email)
[email](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.email)
The customer's email address.
***
currency
read-only
->
[](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.currencyCode)
[currencyCode](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.currencyCode)
The three letter code ([ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format) for the currency used for the payment.
***
invoice\_sent\_at
read-only
->
[](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.invoiceSentAt)
[invoiceSentAt](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.invoiceSentAt)
The date and time ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format) when the invoice was emailed to the customer.
***
invoice\_url
read-only
->
[](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.invoiceUrl)
[invoiceUrl](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.invoiceUrl)
The URL for the invoice.
***
{}
## The DraftOrder resource
```json
{
"id": 450789469,
"order_id": {
"id": 456789101
},
"name": "#1001",
"customer": {
"id": 207119551,
"email": "bob.norman@mail.example.com",
"accepts_marketing": false,
"created_at": "2012-03-13T16:09:55-04:00",
"updated_at": "2012-03-13T16:09:55-04:00",
"first_name": "Bob",
"last_name": "Norman",
"orders_count": "1",
"state": "disabled",
"total_spent": "0.00",
"last_order_id": 450789469,
"note": null,
"verified_email": true,
"multipass_identifier": null,
"tax_exempt": false,
"tax_exemptions": {},
"phone": "+13125551212",
"tags": "loyal",
"last_order_name": "#1001",
"currency": "USD",
"addresses": {},
"admin_graphql_api_id": "gid://shopify/Customer/207119551",
"default_address": {}
},
"shipping_address": {
"address1": "123 Amoebobacterieae St",
"address2": "",
"city": "Ottawa",
"company": null,
```
***
## postCreate a new DraftOrder
[](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderCreate)
[draftOrderCreate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderCreate)
Creates a draft order.
Using the `DraftOrder` resource you can create orders in draft state using product variant line items, or custom line items. To create a product variant draft order, provide the `variant_id`, `quantity` and `discount` properties. To create a custom line item, provide the `title`, `price`, `taxable`, and `quantity` properties.
Note
If you are using this endpoint with a Partner development store or a trial store, then you can only create five draft orders per minute.
### Polling
When you create and update draft orders some calculations are done asynchronously, such as calculating shipping and taxes. There might be times when a draft order is created but these calculations haven't completed. In these cases, you need to poll the draft order until the calculations are finished. When a draft order requires polling, a `202 accepted` response code is returned along with `location` and `retry-after` response headers. The `location` header refers to the URL to be polled, and `retry-after` denotes the interval (in seconds) at which polling requests should be sent. When the draft order is ready, a `200 OK` response code will be returned.
### About custom shipping lines
You can use the DraftOrder resource to send orders with custom shipping lines. A custom shipping line includes a `title` and `price` with `handle` set to `Nil`. A shipping line with a carrier provided shipping rate (currently set via the Shopify admin) includes the shipping rate handle.
### Applying discounts
A draft order and its line items can have one discount each. Calculations for discounts are based on the setting of the `value_type` property, which can be set to either `fixed_amount` or `percentage`. For example, you can apply a fixed amount discount to a draft order to reduce the price by the specified `value` property. When you use a percentage discount, the discount `amount` property is the price multiplied by the `value` property. For line item discounts, the `value` property is applied per individual unit of the item, based on the line item's quantity.
**Calculating line item discount amounts**
For `fixed_amount` discounts, the total `amount` corresponds to the line item quantity times the value of the discount. For percentage discounts, the total `amount` corresponds to the following:
`amount = floor(price * quantity * value) / 100`, where `floor()` is the usual round down function.
For non-fractional currencies, this formula needs to use `round()` instead of `floor()`, and the division by 100 takes place inside the rounding, resulting in a non-fractional value. Otherwise, an error is returned.
`amount = round(price * quantity * value / 100)`
**Line item examples**
*Fixed amount discount*
For a $19.99 line item with quantity of 2 and with $5 dollars off, discount amount corresponds to $10 ($5 \* 2):
`applied_discount: { "value_type": "fixed_amount", "value": 5, "amount": 10 }`
*Percentage discount*
For a $19.99 line item with quantity of 2 and with 15% off, discount amount corresponds to $5.99 (floor ($19.99 \* 2 \* 15) / 100):
`applied_discount: { "value_type": "percentage", "value": 15, "amount": 5.99 }`
### Loading and removing customers
You can load a customer to a draft order by sending the `customer_id` as part of the draft order resource. We recommend removing a customer from a draft order by making a POST request with the `Customer` resource set to `null`, without specifying an email, shipping address, or billing address. A customer can also be removed by setting `customer`, `email`, `shipping_address`, and `billing_address` to `null`.
### Parameters
***
api\_version
string
required
***
customer\_id
Used to load the customer. When a customer is loaded, the customer’s email address is also associated.
***
use\_customer\_default\_address
boolean
default false
An optional boolean that you can send as part of a draft order resource to load customer shipping information. Valid values: true or false.
***
### Examples
Create a draft order with a discount
Request body
draft\_order[](https://shopify.dev/apps/store/data-protection/protected-customer-data)
Draft\_order resource
Show draft\_order properties
draft\_order.line\_items:\[{"title":"Custom Tee","price":"20.00","quantity":2}]
->
[](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
[lineItems](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
The product variant line item or custom line item associated to the draft order. Each draft order must include at least one `line_item`. Note that Draft orders don't currently support subscriptions. Each `line_item` resource has the following properties:
Show line\_items properties
* **custom**: *Read only field* Whether this is a custom line item or a product variant line item. If set to `true` indicates a custom line item. If set to `false` indicates a product variant line item.
* **id**: The ID of the line item.
* **variant\_id**: The ID of the product variant corresponding to the line item. Required for a product variant line item. Set to `null` for a custom line item.
* **product\_id**: The ID of the product corresponding to the line item’s product variant.
* **name**: The name of the product.
* **variant\_title**: The title of the product variant. Defaults to `Custom` for custom line items created via the API.
* **vendor**: The vendor.
* **quantity**: The number of products that were purchased.
* **gift\_card**: Indicates if the product is a gift card. Valid values: `true` or `false`.
* **fulfillment\_service**: The service provider responsible for fulfillment. Valid values are either `manual` or the name of the provider, for example amazon, shipwire. Defaults to `manual` for custom line items.
* **properties**: An array of custom information for an item that has been added to the draft order, often used to provide [product customization options](https://shopify.dev/api/liquid/objects/line_item#line_item-properties). Copied to created order when draft order is completed.
* **applied\_discount**: The discount applied to the line item. For more information, see the `applied_discount` property.
* **tax\_lines**: *Read only field* The calculated rate and amount of taxes for the line item.
* * **price**: The amount of tax to be charged.
* **rate**: The rate of tax to be applied.
* **title**: The name of the tax.
**title**: The title of the product or variant. Applicable only to custom line items. *Required field*.
* **price**: The price of the item before discounts have been applied. Applicable only to custom line items. *Required field*.
* **grams**: The weight of the item in grams. Applicable only to custom line items. If not specified, defaults to 0.
* **requires\_shipping**: Whether the fulfillment requires shipping. Applicable only to custom line items. Valid values: `true` or `false.`
* **sku**: A unique identifier for the item in the fulfillment. Applicable only to custom line items.
* **taxable**: Whether the product is taxable. Applicable only to custom line items.
draft\_order.applied\_discount:{"description":"Custom discount","value\_type":"fixed\_amount","value":"10.0","amount":"10.00","title":"Custom"}
->
[](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-appliedDiscount)
[appliedDiscount](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-appliedDiscount)
The discount applied to the line item or the draft order resource. Each draft order resource can have one `applied_discount` resource and each draft order line item can have its own `applied_discount`. The `applied_discount` resource has the following properties:
Show applied\_discount properties
* **title**: Title of the discount.
* **description**: Reason for the discount.
* **value**: The value of the discount. If the type of discount is `fixed_amount`, then it corresponds to a fixed dollar amount. If the type is `percentage`, then it corresponds to percentage.
* **value\_type**: The type of discount. Valid values: `percentage`, `fixed_amount`.
* **amount**: The applied amount of the discount, based on the setting of `value_type`. For more information, see [*Applying discounts*](#applying-discounts).
draft\_order.customer:{"id":207119551}
The customer resource, which contains information about the customer. Learn more about [loading and removing customers](#loading-and-removing-customers). For more information about the `customer` resource, see the [Customer](https://shopify.dev/api/admin-rest/current/resources/customer) documentation.
Create a draft order with a percent discount on a line item
Request body
draft\_order[](https://shopify.dev/apps/store/data-protection/protected-customer-data)
Draft\_order resource
Show draft\_order properties
draft\_order.line\_items:\[{"title":"Custom Tee","price":"20.00","quantity":1,"applied\_discount":{"description":"Custom discount","value\_type":"percentage","value":"10.0","amount":"2.0","title":"Custom"}}]
->
[](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
[lineItems](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
The product variant line item or custom line item associated to the draft order. Each draft order must include at least one `line_item`. Note that Draft orders don't currently support subscriptions. Each `line_item` resource has the following properties:
Show line\_items properties
* **custom**: *Read only field* Whether this is a custom line item or a product variant line item. If set to `true` indicates a custom line item. If set to `false` indicates a product variant line item.
* **id**: The ID of the line item.
* **variant\_id**: The ID of the product variant corresponding to the line item. Required for a product variant line item. Set to `null` for a custom line item.
* **product\_id**: The ID of the product corresponding to the line item’s product variant.
* **name**: The name of the product.
* **variant\_title**: The title of the product variant. Defaults to `Custom` for custom line items created via the API.
* **vendor**: The vendor.
* **quantity**: The number of products that were purchased.
* **gift\_card**: Indicates if the product is a gift card. Valid values: `true` or `false`.
* **fulfillment\_service**: The service provider responsible for fulfillment. Valid values are either `manual` or the name of the provider, for example amazon, shipwire. Defaults to `manual` for custom line items.
* **properties**: An array of custom information for an item that has been added to the draft order, often used to provide [product customization options](https://shopify.dev/api/liquid/objects/line_item#line_item-properties). Copied to created order when draft order is completed.
* **applied\_discount**: The discount applied to the line item. For more information, see the `applied_discount` property.
* **tax\_lines**: *Read only field* The calculated rate and amount of taxes for the line item.
* * **price**: The amount of tax to be charged.
* **rate**: The rate of tax to be applied.
* **title**: The name of the tax.
**title**: The title of the product or variant. Applicable only to custom line items. *Required field*.
* **price**: The price of the item before discounts have been applied. Applicable only to custom line items. *Required field*.
* **grams**: The weight of the item in grams. Applicable only to custom line items. If not specified, defaults to 0.
* **requires\_shipping**: Whether the fulfillment requires shipping. Applicable only to custom line items. Valid values: `true` or `false.`
* **sku**: A unique identifier for the item in the fulfillment. Applicable only to custom line items.
* **taxable**: Whether the product is taxable. Applicable only to custom line items.
Create custom draft order
Request body
draft\_order[](https://shopify.dev/apps/store/data-protection/protected-customer-data)
Draft\_order resource
Show draft\_order properties
draft\_order.line\_items:\[{"title":"Custom Tee","price":"20.00","quantity":2}]
->
[](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
[lineItems](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
The product variant line item or custom line item associated to the draft order. Each draft order must include at least one `line_item`. Note that Draft orders don't currently support subscriptions. Each `line_item` resource has the following properties:
Show line\_items properties
* **custom**: *Read only field* Whether this is a custom line item or a product variant line item. If set to `true` indicates a custom line item. If set to `false` indicates a product variant line item.
* **id**: The ID of the line item.
* **variant\_id**: The ID of the product variant corresponding to the line item. Required for a product variant line item. Set to `null` for a custom line item.
* **product\_id**: The ID of the product corresponding to the line item’s product variant.
* **name**: The name of the product.
* **variant\_title**: The title of the product variant. Defaults to `Custom` for custom line items created via the API.
* **vendor**: The vendor.
* **quantity**: The number of products that were purchased.
* **gift\_card**: Indicates if the product is a gift card. Valid values: `true` or `false`.
* **fulfillment\_service**: The service provider responsible for fulfillment. Valid values are either `manual` or the name of the provider, for example amazon, shipwire. Defaults to `manual` for custom line items.
* **properties**: An array of custom information for an item that has been added to the draft order, often used to provide [product customization options](https://shopify.dev/api/liquid/objects/line_item#line_item-properties). Copied to created order when draft order is completed.
* **applied\_discount**: The discount applied to the line item. For more information, see the `applied_discount` property.
* **tax\_lines**: *Read only field* The calculated rate and amount of taxes for the line item.
* * **price**: The amount of tax to be charged.
* **rate**: The rate of tax to be applied.
* **title**: The name of the tax.
**title**: The title of the product or variant. Applicable only to custom line items. *Required field*.
* **price**: The price of the item before discounts have been applied. Applicable only to custom line items. *Required field*.
* **grams**: The weight of the item in grams. Applicable only to custom line items. If not specified, defaults to 0.
* **requires\_shipping**: Whether the fulfillment requires shipping. Applicable only to custom line items. Valid values: `true` or `false.`
* **sku**: A unique identifier for the item in the fulfillment. Applicable only to custom line items.
* **taxable**: Whether the product is taxable. Applicable only to custom line items.
draft\_order.customer:{"id":207119551}
The customer resource, which contains information about the customer. Learn more about [loading and removing customers](#loading-and-removing-customers). For more information about the `customer` resource, see the [Customer](https://shopify.dev/api/admin-rest/current/resources/customer) documentation.
Create draft order with custom billing address
Request body
draft\_order[](https://shopify.dev/apps/store/data-protection/protected-customer-data)
Draft\_order resource
Show draft\_order properties
draft\_order.line\_items:\[{"variant\_id":447654529,"quantity":1}]
->
[](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
[lineItems](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
The product variant line item or custom line item associated to the draft order. Each draft order must include at least one `line_item`. Note that Draft orders don't currently support subscriptions. Each `line_item` resource has the following properties:
Show line\_items properties
* **custom**: *Read only field* Whether this is a custom line item or a product variant line item. If set to `true` indicates a custom line item. If set to `false` indicates a product variant line item.
* **id**: The ID of the line item.
* **variant\_id**: The ID of the product variant corresponding to the line item. Required for a product variant line item. Set to `null` for a custom line item.
* **product\_id**: The ID of the product corresponding to the line item’s product variant.
* **name**: The name of the product.
* **variant\_title**: The title of the product variant. Defaults to `Custom` for custom line items created via the API.
* **vendor**: The vendor.
* **quantity**: The number of products that were purchased.
* **gift\_card**: Indicates if the product is a gift card. Valid values: `true` or `false`.
* **fulfillment\_service**: The service provider responsible for fulfillment. Valid values are either `manual` or the name of the provider, for example amazon, shipwire. Defaults to `manual` for custom line items.
* **properties**: An array of custom information for an item that has been added to the draft order, often used to provide [product customization options](https://shopify.dev/api/liquid/objects/line_item#line_item-properties). Copied to created order when draft order is completed.
* **applied\_discount**: The discount applied to the line item. For more information, see the `applied_discount` property.
* **tax\_lines**: *Read only field* The calculated rate and amount of taxes for the line item.
* * **price**: The amount of tax to be charged.
* **rate**: The rate of tax to be applied.
* **title**: The name of the tax.
**title**: The title of the product or variant. Applicable only to custom line items. *Required field*.
* **price**: The price of the item before discounts have been applied. Applicable only to custom line items. *Required field*.
* **grams**: The weight of the item in grams. Applicable only to custom line items. If not specified, defaults to 0.
* **requires\_shipping**: Whether the fulfillment requires shipping. Applicable only to custom line items. Valid values: `true` or `false.`
* **sku**: A unique identifier for the item in the fulfillment. Applicable only to custom line items.
* **taxable**: Whether the product is taxable. Applicable only to custom line items.
draft\_order.billing\_address:{"first\_name":"Bob","last\_name":"Norman","address1":"123 Main St","city":"Anytown","province":"ON","country":"Canada","zip":"A1B2C3","phone":"555-555-5555"}
->
[](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-billingAddress)
[billingAddress](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-billingAddress)
The mailing address associated with the payment method. This address is an optional field that won't be available on orders that do not require a payment method. The `billing_address` resource has the following properties:
Show billing\_address properties
* **address1**: The street address of the billing address.
* **address2**: An optional additional field for the street address of the billing address.
* **city**: The city of the billing address.
* **company**: The company of the person associated with the billing address.
* **country**: The name of the country of the billing address.
* **country\_code**: The two-letter code ([ISO 3166-1 alpha-2 two-letter country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)) for the country of the billing address.
* **first\_name**: The first name of the person associated with the payment method.
* **last\_name**: The last name of the person associated with the payment method.
* **latitude**: The latitude of the billing address.
* **longitude**: The longitude of the billing address.
* **name**: The full name of the person associated with the payment method.
* **phone**: The phone number at the billing address.
* **province**: The name of the billing address region, such as province, state, or prefecture.
* **province\_code**: The alphanumeric abbreviation of the region for the billing address.
* **zip**: The postal code of the billing address, such as zip, postcode, or Eircode.
Create draft order with custom shipping address
Request body
draft\_order[](https://shopify.dev/apps/store/data-protection/protected-customer-data)
Draft\_order resource
Show draft\_order properties
draft\_order.line\_items:\[{"variant\_id":447654529,"quantity":1}]
->
[](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
[lineItems](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
The product variant line item or custom line item associated to the draft order. Each draft order must include at least one `line_item`. Note that Draft orders don't currently support subscriptions. Each `line_item` resource has the following properties:
Show line\_items properties
* **custom**: *Read only field* Whether this is a custom line item or a product variant line item. If set to `true` indicates a custom line item. If set to `false` indicates a product variant line item.
* **id**: The ID of the line item.
* **variant\_id**: The ID of the product variant corresponding to the line item. Required for a product variant line item. Set to `null` for a custom line item.
* **product\_id**: The ID of the product corresponding to the line item’s product variant.
* **name**: The name of the product.
* **variant\_title**: The title of the product variant. Defaults to `Custom` for custom line items created via the API.
* **vendor**: The vendor.
* **quantity**: The number of products that were purchased.
* **gift\_card**: Indicates if the product is a gift card. Valid values: `true` or `false`.
* **fulfillment\_service**: The service provider responsible for fulfillment. Valid values are either `manual` or the name of the provider, for example amazon, shipwire. Defaults to `manual` for custom line items.
* **properties**: An array of custom information for an item that has been added to the draft order, often used to provide [product customization options](https://shopify.dev/api/liquid/objects/line_item#line_item-properties). Copied to created order when draft order is completed.
* **applied\_discount**: The discount applied to the line item. For more information, see the `applied_discount` property.
* **tax\_lines**: *Read only field* The calculated rate and amount of taxes for the line item.
* * **price**: The amount of tax to be charged.
* **rate**: The rate of tax to be applied.
* **title**: The name of the tax.
**title**: The title of the product or variant. Applicable only to custom line items. *Required field*.
* **price**: The price of the item before discounts have been applied. Applicable only to custom line items. *Required field*.
* **grams**: The weight of the item in grams. Applicable only to custom line items. If not specified, defaults to 0.
* **requires\_shipping**: Whether the fulfillment requires shipping. Applicable only to custom line items. Valid values: `true` or `false.`
* **sku**: A unique identifier for the item in the fulfillment. Applicable only to custom line items.
* **taxable**: Whether the product is taxable. Applicable only to custom line items.
draft\_order.shipping\_address:{"first\_name":"Bob","last\_name":"Norman","address1":"123 Main St","city":"Anytown","province":"ON","country":"Canada","zip":"A1B2C3","phone":"555-555-5555"}
->
[](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-shippingAddress)
[shippingAddress](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-shippingAddress)
The address to ship the order to. The `shipping_address` is optional and will not be available on orders that don't require shipping. The `shipping_address` resource has the following properties:
Show shipping\_address properties
* **address1**: The street address of the shipping address.
* **address2**: An optional additional field for the street address of the shipping address.
* **city**: The city of the shipping address.
* **company**: The company of the person associated with the shipping address.
* **country**: The name of the country of the shipping address.
* **country\_code**: The two-letter code for the country of the shipping address.
* **first\_name**: The first name of the person associated with the payment method.
* **last\_name**: The last name of the person associated with the payment method.
* **latitude**: The latitude of the shipping address.
* **longitude**: The longitude of the shipping address.
* **name**: The full name of the person associated with the payment method.
* **phone**: The phone number at the shipping address.
* **province**: The name of the state or province of the shipping address.
* **province\_code**: The alphanumeric abbreviation of the state or province of the shipping address.
* **zip**: The zip or postal code of the shipping address.
Create a draft order with a discounted line item
Request body
draft\_order[](https://shopify.dev/apps/store/data-protection/protected-customer-data)
Draft\_order resource
Show draft\_order properties
draft\_order.line\_items:\[{"title":"Custom Tee","price":"20.00","quantity":1,"applied\_discount":{"description":"Custom discount","value\_type":"fixed\_amount","value":"10.0","amount":"10.0","title":"Custom"}}]
->
[](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
[lineItems](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
The product variant line item or custom line item associated to the draft order. Each draft order must include at least one `line_item`. Note that Draft orders don't currently support subscriptions. Each `line_item` resource has the following properties:
Show line\_items properties
* **custom**: *Read only field* Whether this is a custom line item or a product variant line item. If set to `true` indicates a custom line item. If set to `false` indicates a product variant line item.
* **id**: The ID of the line item.
* **variant\_id**: The ID of the product variant corresponding to the line item. Required for a product variant line item. Set to `null` for a custom line item.
* **product\_id**: The ID of the product corresponding to the line item’s product variant.
* **name**: The name of the product.
* **variant\_title**: The title of the product variant. Defaults to `Custom` for custom line items created via the API.
* **vendor**: The vendor.
* **quantity**: The number of products that were purchased.
* **gift\_card**: Indicates if the product is a gift card. Valid values: `true` or `false`.
* **fulfillment\_service**: The service provider responsible for fulfillment. Valid values are either `manual` or the name of the provider, for example amazon, shipwire. Defaults to `manual` for custom line items.
* **properties**: An array of custom information for an item that has been added to the draft order, often used to provide [product customization options](https://shopify.dev/api/liquid/objects/line_item#line_item-properties). Copied to created order when draft order is completed.
* **applied\_discount**: The discount applied to the line item. For more information, see the `applied_discount` property.
* **tax\_lines**: *Read only field* The calculated rate and amount of taxes for the line item.
* * **price**: The amount of tax to be charged.
* **rate**: The rate of tax to be applied.
* **title**: The name of the tax.
**title**: The title of the product or variant. Applicable only to custom line items. *Required field*.
* **price**: The price of the item before discounts have been applied. Applicable only to custom line items. *Required field*.
* **grams**: The weight of the item in grams. Applicable only to custom line items. If not specified, defaults to 0.
* **requires\_shipping**: Whether the fulfillment requires shipping. Applicable only to custom line items. Valid values: `true` or `false.`
* **sku**: A unique identifier for the item in the fulfillment. Applicable only to custom line items.
* **taxable**: Whether the product is taxable. Applicable only to custom line items.
Create a simple draft order with only a product variant ID.
Request body
draft\_order[](https://shopify.dev/apps/store/data-protection/protected-customer-data)
Draft\_order resource
Show draft\_order properties
draft\_order.line\_items:\[{"variant\_id":447654529,"quantity":1}]
->
[](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
[lineItems](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
The product variant line item or custom line item associated to the draft order. Each draft order must include at least one `line_item`. Note that Draft orders don't currently support subscriptions. Each `line_item` resource has the following properties:
Show line\_items properties
* **custom**: *Read only field* Whether this is a custom line item or a product variant line item. If set to `true` indicates a custom line item. If set to `false` indicates a product variant line item.
* **id**: The ID of the line item.
* **variant\_id**: The ID of the product variant corresponding to the line item. Required for a product variant line item. Set to `null` for a custom line item.
* **product\_id**: The ID of the product corresponding to the line item’s product variant.
* **name**: The name of the product.
* **variant\_title**: The title of the product variant. Defaults to `Custom` for custom line items created via the API.
* **vendor**: The vendor.
* **quantity**: The number of products that were purchased.
* **gift\_card**: Indicates if the product is a gift card. Valid values: `true` or `false`.
* **fulfillment\_service**: The service provider responsible for fulfillment. Valid values are either `manual` or the name of the provider, for example amazon, shipwire. Defaults to `manual` for custom line items.
* **properties**: An array of custom information for an item that has been added to the draft order, often used to provide [product customization options](https://shopify.dev/api/liquid/objects/line_item#line_item-properties). Copied to created order when draft order is completed.
* **applied\_discount**: The discount applied to the line item. For more information, see the `applied_discount` property.
* **tax\_lines**: *Read only field* The calculated rate and amount of taxes for the line item.
* * **price**: The amount of tax to be charged.
* **rate**: The rate of tax to be applied.
* **title**: The name of the tax.
**title**: The title of the product or variant. Applicable only to custom line items. *Required field*.
* **price**: The price of the item before discounts have been applied. Applicable only to custom line items. *Required field*.
* **grams**: The weight of the item in grams. Applicable only to custom line items. If not specified, defaults to 0.
* **requires\_shipping**: Whether the fulfillment requires shipping. Applicable only to custom line items. Valid values: `true` or `false.`
* **sku**: A unique identifier for the item in the fulfillment. Applicable only to custom line items.
* **taxable**: Whether the product is taxable. Applicable only to custom line items.
post
## /admin/api/2025-10/draft\_orders.json
```bash
curl -d '{"draft_order":{"line_items":[{"title":"Custom Tee","price":"20.00","quantity":2}],"applied_discount":{"description":"Custom discount","value_type":"fixed_amount","value":"10.0","amount":"10.00","title":"Custom"},"customer":{"id":207119551},"use_customer_default_address":true}}' \
-X POST "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```
{}
## Response
JSON
```json
HTTP/1.1 201 Created
{
"draft_order": {
"id": 1069920479,
"note": null,
"email": "bob.norman@mail.example.com",
"taxes_included": false,
"currency": "USD",
"invoice_sent_at": null,
"created_at": "2025-10-01T14:55:19-04:00",
"updated_at": "2025-10-01T14:55:19-04:00",
"tax_exempt": false,
"completed_at": null,
"name": "#D3",
"allow_discount_codes_in_checkout?": false,
"b2b?": false,
"status": "open",
"line_items": [
{
"id": 1066630385,
"variant_id": null,
"product_id": null,
"title": "Custom Tee",
"variant_title": null,
"sku": null,
"vendor": null,
"quantity": 2,
"requires_shipping": false,
"taxable": true,
"gift_card": false,
"fulfillment_service": "manual",
"grams": 0,
"tax_lines": [
{
"rate": 0.06,
"title": "Tax",
```
### examples
* #### \Create a draft order with a discount\
#####
```curl
curl -d '{"draft_order":{"line_items":[{"title":"Custom Tee","price":"20.00","quantity":2}],"applied_discount":{"description":"Custom discount","value_type":"fixed_amount","value":"10.0","amount":"10.00","title":"Custom"},"customer":{"id":207119551},"use_customer_default_address":true}}' \
-X POST "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```
#####
```remix
const { admin, session } = await authenticate.admin(request);
const draft_order = new admin.rest.resources.DraftOrder({session: session});
draft_order.line_items = [
{
"title": "Custom Tee",
"price": "20.00",
"quantity": 2
}
];
draft_order.applied_discount = {
"description": "Custom discount",
"value_type": "fixed_amount",
"value": "10.0",
"amount": "10.00",
"title": "Custom"
};
draft_order.customer = {
"id": 207119551
};
draft_order.use_customer_default_address = true;
await draft_order.save({
update: true,
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
draft_order = ShopifyAPI::DraftOrder.new(session: test_session)
draft_order.line_items = [
{
"title" => "Custom Tee",
"price" => "20.00",
"quantity" => 2
}
]
draft_order.applied_discount = {
"description" => "Custom discount",
"value_type" => "fixed_amount",
"value" => "10.0",
"amount" => "10.00",
"title" => "Custom"
}
draft_order.customer = {
"id" => 207119551
}
draft_order.use_customer_default_address = true
draft_order.save!
```
#####
```node
// Session is built by the OAuth process
const draft_order = new shopify.rest.DraftOrder({session: session});
draft_order.line_items = [
{
"title": "Custom Tee",
"price": "20.00",
"quantity": 2
}
];
draft_order.applied_discount = {
"description": "Custom discount",
"value_type": "fixed_amount",
"value": "10.0",
"amount": "10.00",
"title": "Custom"
};
draft_order.customer = {
"id": 207119551
};
draft_order.use_customer_default_address = true;
await draft_order.save({
update: true,
});
```
#### response
```json
HTTP/1.1 201 Created{"draft_order":{"id":1069920479,"note":null,"email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:55:19-04:00","updated_at":"2025-10-01T14:55:19-04:00","tax_exempt":false,"completed_at":null,"name":"#D3","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":1066630385,"variant_id":null,"product_id":null,"title":"Custom Tee","variant_title":null,"sku":null,"vendor":null,"quantity":2,"requires_shipping":false,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":0,"tax_lines":[{"rate":0.06,"title":"Tax","price":"1.80"}],"applied_discount":null,"name":"Custom Tee","properties":[],"custom":true,"price":"20.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/1066630385"}],"api_client_id":755357713,"shipping_address":{"first_name":null,"address1":"Chestnut Street 92","phone":"555-625-1199","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":null,"address2":"","company":null,"latitude":null,"longitude":null,"name":"","country_code":"US","province_code":"KY"},"billing_address":{"first_name":null,"address1":"Chestnut Street 92","phone":"555-625-1199","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":null,"address2":"","company":null,"latitude":null,"longitude":null,"name":"","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/a90676b37da6f28b28bcbcdd4c392092","created_on_api_version_handle":"unstable","applied_discount":{"description":"Custom discount","value":"10.0","title":"Custom","amount":"10.00","value_type":"fixed_amount"},"order_id":null,"shipping_line":null,"tax_lines":[{"rate":0.06,"title":"Tax","price":"1.80"}],"tags":"","note_attributes":[],"total_price":"31.80","subtotal_price":"30.00","total_tax":"1.80","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"40.00","currency_code":"USD"},"presentment_money":{"amount":"40.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"31.80","currency_code":"USD"},"presentment_money":{"amount":"31.80","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"30.00","currency_code":"USD"},"presentment_money":{"amount":"30.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"1.80","currency_code":"USD"},"presentment_money":{"amount":"1.80","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"31.80","currency_code":"USD"},"presentment_money":{"amount":"31.80","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/1069920479","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}}}
```
* #### \Create a draft order with a percent discount on a line item\
#####
```curl
curl -d '{"draft_order":{"line_items":[{"title":"Custom Tee","price":"20.00","quantity":1,"applied_discount":{"description":"Custom discount","value_type":"percentage","value":"10.0","amount":"2.0","title":"Custom"}}]}}' \
-X POST "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```
#####
```remix
const { admin, session } = await authenticate.admin(request);
const draft_order = new admin.rest.resources.DraftOrder({session: session});
draft_order.line_items = [
{
"title": "Custom Tee",
"price": "20.00",
"quantity": 1,
"applied_discount": {
"description": "Custom discount",
"value_type": "percentage",
"value": "10.0",
"amount": "2.0",
"title": "Custom"
}
}
];
await draft_order.save({
update: true,
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
draft_order = ShopifyAPI::DraftOrder.new(session: test_session)
draft_order.line_items = [
{
"title" => "Custom Tee",
"price" => "20.00",
"quantity" => 1,
"applied_discount" => {
"description" => "Custom discount",
"value_type" => "percentage",
"value" => "10.0",
"amount" => "2.0",
"title" => "Custom"
}
}
]
draft_order.save!
```
#####
```node
// Session is built by the OAuth process
const draft_order = new shopify.rest.DraftOrder({session: session});
draft_order.line_items = [
{
"title": "Custom Tee",
"price": "20.00",
"quantity": 1,
"applied_discount": {
"description": "Custom discount",
"value_type": "percentage",
"value": "10.0",
"amount": "2.0",
"title": "Custom"
}
}
];
await draft_order.save({
update: true,
});
```
#### response
```json
HTTP/1.1 201 Created{"draft_order":{"id":1069920481,"note":null,"email":null,"taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:55:22-04:00","updated_at":"2025-10-01T14:55:22-04:00","tax_exempt":false,"completed_at":null,"name":"#D3","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":1066630387,"variant_id":null,"product_id":null,"title":"Custom Tee","variant_title":null,"sku":null,"vendor":null,"quantity":1,"requires_shipping":false,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":0,"tax_lines":[{"rate":0.05,"title":"GST","price":"0.90"},{"rate":0.08,"title":"Tax","price":"1.44"}],"applied_discount":{"description":"Custom discount","value":"10.0","title":"Custom","amount":"2.00","value_type":"percentage"},"name":"Custom Tee","properties":[],"custom":true,"price":"20.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/1066630387"}],"api_client_id":755357713,"shipping_address":null,"billing_address":null,"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/4c6b6bea021efc59f9f82ead69145fe0","created_on_api_version_handle":"unstable","applied_discount":null,"order_id":null,"shipping_line":null,"tax_lines":[{"rate":0.05,"title":"GST","price":"0.90"},{"rate":0.08,"title":"Tax","price":"1.44"}],"tags":"","note_attributes":[],"total_price":"20.34","subtotal_price":"18.00","total_tax":"2.34","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"20.00","currency_code":"USD"},"presentment_money":{"amount":"20.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"20.34","currency_code":"USD"},"presentment_money":{"amount":"20.34","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"18.00","currency_code":"USD"},"presentment_money":{"amount":"18.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"2.34","currency_code":"USD"},"presentment_money":{"amount":"2.34","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"2.00","currency_code":"USD"},"presentment_money":{"amount":"2.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"20.34","currency_code":"USD"},"presentment_money":{"amount":"20.34","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/1069920481"}}
```
* #### \Create custom draft order\
#####
```curl
curl -d '{"draft_order":{"line_items":[{"title":"Custom Tee","price":"20.00","quantity":2}],"customer":{"id":207119551},"use_customer_default_address":true}}' \
-X POST "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```
#####
```remix
const { admin, session } = await authenticate.admin(request);
const draft_order = new admin.rest.resources.DraftOrder({session: session});
draft_order.line_items = [
{
"title": "Custom Tee",
"price": "20.00",
"quantity": 2
}
];
draft_order.customer = {
"id": 207119551
};
draft_order.use_customer_default_address = true;
await draft_order.save({
update: true,
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
draft_order = ShopifyAPI::DraftOrder.new(session: test_session)
draft_order.line_items = [
{
"title" => "Custom Tee",
"price" => "20.00",
"quantity" => 2
}
]
draft_order.customer = {
"id" => 207119551
}
draft_order.use_customer_default_address = true
draft_order.save!
```
#####
```node
// Session is built by the OAuth process
const draft_order = new shopify.rest.DraftOrder({session: session});
draft_order.line_items = [
{
"title": "Custom Tee",
"price": "20.00",
"quantity": 2
}
];
draft_order.customer = {
"id": 207119551
};
draft_order.use_customer_default_address = true;
await draft_order.save({
update: true,
});
```
#### response
```json
HTTP/1.1 201 Created{"draft_order":{"id":1069920480,"note":null,"email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:55:21-04:00","updated_at":"2025-10-01T14:55:21-04:00","tax_exempt":false,"completed_at":null,"name":"#D3","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":1066630386,"variant_id":null,"product_id":null,"title":"Custom Tee","variant_title":null,"sku":null,"vendor":null,"quantity":2,"requires_shipping":false,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":0,"tax_lines":[{"rate":0.06,"title":"Tax","price":"2.40"}],"applied_discount":null,"name":"Custom Tee","properties":[],"custom":true,"price":"20.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/1066630386"}],"api_client_id":755357713,"shipping_address":{"first_name":null,"address1":"Chestnut Street 92","phone":"555-625-1199","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":null,"address2":"","company":null,"latitude":null,"longitude":null,"name":"","country_code":"US","province_code":"KY"},"billing_address":{"first_name":null,"address1":"Chestnut Street 92","phone":"555-625-1199","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":null,"address2":"","company":null,"latitude":null,"longitude":null,"name":"","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/4d50c8f4bcc7b8e40d49cebc3f376995","created_on_api_version_handle":"unstable","applied_discount":null,"order_id":null,"shipping_line":null,"tax_lines":[{"rate":0.06,"title":"Tax","price":"2.40"}],"tags":"","note_attributes":[],"total_price":"42.40","subtotal_price":"40.00","total_tax":"2.40","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"40.00","currency_code":"USD"},"presentment_money":{"amount":"40.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"42.40","currency_code":"USD"},"presentment_money":{"amount":"42.40","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"40.00","currency_code":"USD"},"presentment_money":{"amount":"40.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"2.40","currency_code":"USD"},"presentment_money":{"amount":"2.40","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"42.40","currency_code":"USD"},"presentment_money":{"amount":"42.40","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/1069920480","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}}}
```
* #### \Create draft order with custom billing address\
#####
```curl
curl -d '{"draft_order":{"line_items":[{"variant_id":447654529,"quantity":1}],"billing_address":{"first_name":"Bob","last_name":"Norman","address1":"123 Main St","city":"Anytown","province":"ON","country":"Canada","zip":"A1B2C3","phone":"555-555-5555"}}}' \
-X POST "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```
#####
```remix
const { admin, session } = await authenticate.admin(request);
const draft_order = new admin.rest.resources.DraftOrder({session: session});
draft_order.line_items = [
{
"variant_id": 447654529,
"quantity": 1
}
];
draft_order.billing_address = {
"first_name": "Bob",
"last_name": "Norman",
"address1": "123 Main St",
"city": "Anytown",
"province": "ON",
"country": "Canada",
"zip": "A1B2C3",
"phone": "555-555-5555"
};
await draft_order.save({
update: true,
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
draft_order = ShopifyAPI::DraftOrder.new(session: test_session)
draft_order.line_items = [
{
"variant_id" => 447654529,
"quantity" => 1
}
]
draft_order.billing_address = {
"first_name" => "Bob",
"last_name" => "Norman",
"address1" => "123 Main St",
"city" => "Anytown",
"province" => "ON",
"country" => "Canada",
"zip" => "A1B2C3",
"phone" => "555-555-5555"
}
draft_order.save!
```
#####
```node
// Session is built by the OAuth process
const draft_order = new shopify.rest.DraftOrder({session: session});
draft_order.line_items = [
{
"variant_id": 447654529,
"quantity": 1
}
];
draft_order.billing_address = {
"first_name": "Bob",
"last_name": "Norman",
"address1": "123 Main St",
"city": "Anytown",
"province": "ON",
"country": "Canada",
"zip": "A1B2C3",
"phone": "555-555-5555"
};
await draft_order.save({
update: true,
});
```
#### response
```json
HTTP/1.1 201 Created{"draft_order":{"id":1069920478,"note":null,"email":null,"taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:55:17-04:00","updated_at":"2025-10-01T14:55:17-04:00","tax_exempt":false,"completed_at":null,"name":"#D3","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":1066630384,"variant_id":447654529,"product_id":921728736,"title":"IPod Touch 8GB","variant_title":"Black","sku":"IPOD2009BLACK","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.05,"title":"GST","price":"9.95"},{"rate":0.08,"title":"Tax","price":"15.92"}],"applied_discount":null,"name":"IPod Touch 8GB - Black","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/1066630384"}],"api_client_id":755357713,"shipping_address":null,"billing_address":{"first_name":"Bob","address1":"123 Main St","phone":"555-555-5555","city":"Anytown","zip":"A1B2C3","province":"Ontario","country":"Canada","last_name":"Norman","address2":null,"company":null,"latitude":null,"longitude":null,"name":"Bob Norman","country_code":"CA","province_code":"ON"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/447bd242e4f3d1a4733c91f342fce12a","created_on_api_version_handle":"unstable","applied_discount":null,"order_id":null,"shipping_line":null,"tax_lines":[{"rate":0.05,"title":"GST","price":"9.95"},{"rate":0.08,"title":"Tax","price":"15.92"}],"tags":"","note_attributes":[],"total_price":"224.87","subtotal_price":"199.00","total_tax":"25.87","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"224.87","currency_code":"USD"},"presentment_money":{"amount":"224.87","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"25.87","currency_code":"USD"},"presentment_money":{"amount":"25.87","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"224.87","currency_code":"USD"},"presentment_money":{"amount":"224.87","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/1069920478","customer":{"id":1073339457,"created_at":"2025-10-01T14:55:17-04:00","updated_at":"2025-10-01T14:55:17-04:00","first_name":"Bob","last_name":"Norman","orders_count":0,"state":"disabled","total_spent":"0.00","last_order_id":null,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"","last_order_name":null,"email":null,"phone":null,"currency":"USD","tax_exemptions":[],"email_marketing_consent":null,"sms_marketing_consent":null,"admin_graphql_api_id":"gid://shopify/Customer/1073339457","default_address":{"id":1053317289,"customer_id":1073339457,"first_name":"Bob","last_name":"Norman","company":null,"address1":"123 Main St","address2":null,"city":"Anytown","province":null,"country":"Canada","zip":"A1B2C3","phone":"555-555-5555","name":"Bob Norman","province_code":null,"country_code":"CA","country_name":"Canada","default":true}}}}
```
* #### \Create draft order with custom shipping address\
#####
```curl
curl -d '{"draft_order":{"line_items":[{"variant_id":447654529,"quantity":1}],"shipping_address":{"first_name":"Bob","last_name":"Norman","address1":"123 Main St","city":"Anytown","province":"ON","country":"Canada","zip":"A1B2C3","phone":"555-555-5555"}}}' \
-X POST "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```
#####
```remix
const { admin, session } = await authenticate.admin(request);
const draft_order = new admin.rest.resources.DraftOrder({session: session});
draft_order.line_items = [
{
"variant_id": 447654529,
"quantity": 1
}
];
draft_order.shipping_address = {
"first_name": "Bob",
"last_name": "Norman",
"address1": "123 Main St",
"city": "Anytown",
"province": "ON",
"country": "Canada",
"zip": "A1B2C3",
"phone": "555-555-5555"
};
await draft_order.save({
update: true,
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
draft_order = ShopifyAPI::DraftOrder.new(session: test_session)
draft_order.line_items = [
{
"variant_id" => 447654529,
"quantity" => 1
}
]
draft_order.shipping_address = {
"first_name" => "Bob",
"last_name" => "Norman",
"address1" => "123 Main St",
"city" => "Anytown",
"province" => "ON",
"country" => "Canada",
"zip" => "A1B2C3",
"phone" => "555-555-5555"
}
draft_order.save!
```
#####
```node
// Session is built by the OAuth process
const draft_order = new shopify.rest.DraftOrder({session: session});
draft_order.line_items = [
{
"variant_id": 447654529,
"quantity": 1
}
];
draft_order.shipping_address = {
"first_name": "Bob",
"last_name": "Norman",
"address1": "123 Main St",
"city": "Anytown",
"province": "ON",
"country": "Canada",
"zip": "A1B2C3",
"phone": "555-555-5555"
};
await draft_order.save({
update: true,
});
```
#### response
```json
HTTP/1.1 201 Created{"draft_order":{"id":1069920475,"note":null,"email":null,"taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:54:59-04:00","updated_at":"2025-10-01T14:54:59-04:00","tax_exempt":false,"completed_at":null,"name":"#D3","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":1066630381,"variant_id":447654529,"product_id":921728736,"title":"IPod Touch 8GB","variant_title":"Black","sku":"IPOD2009BLACK","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.05,"title":"GST","price":"9.95"},{"rate":0.08,"title":"Tax","price":"15.92"}],"applied_discount":null,"name":"IPod Touch 8GB - Black","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/1066630381"}],"api_client_id":755357713,"shipping_address":{"first_name":"Bob","address1":"123 Main St","phone":"555-555-5555","city":"Anytown","zip":"A1B2C3","province":"Ontario","country":"Canada","last_name":"Norman","address2":null,"company":null,"latitude":null,"longitude":null,"name":"Bob Norman","country_code":"CA","province_code":"ON"},"billing_address":null,"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/92f776ddbc22c47f3ae18e80ffb1ec77","created_on_api_version_handle":"unstable","applied_discount":null,"order_id":null,"shipping_line":null,"tax_lines":[{"rate":0.05,"title":"GST","price":"9.95"},{"rate":0.08,"title":"Tax","price":"15.92"}],"tags":"","note_attributes":[],"total_price":"224.87","subtotal_price":"199.00","total_tax":"25.87","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"224.87","currency_code":"USD"},"presentment_money":{"amount":"224.87","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"25.87","currency_code":"USD"},"presentment_money":{"amount":"25.87","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"224.87","currency_code":"USD"},"presentment_money":{"amount":"224.87","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/1069920475","customer":{"id":1073339456,"created_at":"2025-10-01T14:54:58-04:00","updated_at":"2025-10-01T14:54:59-04:00","first_name":"Bob","last_name":"Norman","orders_count":0,"state":"disabled","total_spent":"0.00","last_order_id":null,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"","last_order_name":null,"email":null,"phone":null,"currency":"USD","tax_exemptions":[],"email_marketing_consent":null,"sms_marketing_consent":null,"admin_graphql_api_id":"gid://shopify/Customer/1073339456","default_address":{"id":1053317286,"customer_id":1073339456,"first_name":"Bob","last_name":"Norman","company":null,"address1":"123 Main St","address2":null,"city":"Anytown","province":null,"country":"Canada","zip":"A1B2C3","phone":"555-555-5555","name":"Bob Norman","province_code":null,"country_code":"CA","country_name":"Canada","default":true}}}}
```
* #### Create a draft order with a discounted line item
#####
```curl
curl -d '{"draft_order":{"line_items":[{"title":"Custom Tee","price":"20.00","quantity":1,"applied_discount":{"description":"Custom discount","value_type":"fixed_amount","value":"10.0","amount":"10.0","title":"Custom"}}]}}' \
-X POST "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```
#####
```remix
const { admin, session } = await authenticate.admin(request);
const draft_order = new admin.rest.resources.DraftOrder({session: session});
draft_order.line_items = [
{
"title": "Custom Tee",
"price": "20.00",
"quantity": 1,
"applied_discount": {
"description": "Custom discount",
"value_type": "fixed_amount",
"value": "10.0",
"amount": "10.0",
"title": "Custom"
}
}
];
await draft_order.save({
update: true,
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
draft_order = ShopifyAPI::DraftOrder.new(session: test_session)
draft_order.line_items = [
{
"title" => "Custom Tee",
"price" => "20.00",
"quantity" => 1,
"applied_discount" => {
"description" => "Custom discount",
"value_type" => "fixed_amount",
"value" => "10.0",
"amount" => "10.0",
"title" => "Custom"
}
}
]
draft_order.save!
```
#####
```node
// Session is built by the OAuth process
const draft_order = new shopify.rest.DraftOrder({session: session});
draft_order.line_items = [
{
"title": "Custom Tee",
"price": "20.00",
"quantity": 1,
"applied_discount": {
"description": "Custom discount",
"value_type": "fixed_amount",
"value": "10.0",
"amount": "10.0",
"title": "Custom"
}
}
];
await draft_order.save({
update: true,
});
```
#### response
```json
HTTP/1.1 201 Created{"draft_order":{"id":1069920477,"note":null,"email":null,"taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:55:11-04:00","updated_at":"2025-10-01T14:55:11-04:00","tax_exempt":false,"completed_at":null,"name":"#D3","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":1066630383,"variant_id":null,"product_id":null,"title":"Custom Tee","variant_title":null,"sku":null,"vendor":null,"quantity":1,"requires_shipping":false,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":0,"tax_lines":[{"rate":0.05,"title":"GST","price":"0.50"},{"rate":0.08,"title":"Tax","price":"0.80"}],"applied_discount":{"description":"Custom discount","value":"10.0","title":"Custom","amount":"10.00","value_type":"fixed_amount"},"name":"Custom Tee","properties":[],"custom":true,"price":"20.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/1066630383"}],"api_client_id":755357713,"shipping_address":null,"billing_address":null,"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/0c112b7cb3354dbe324489b946a693e6","created_on_api_version_handle":"unstable","applied_discount":null,"order_id":null,"shipping_line":null,"tax_lines":[{"rate":0.05,"title":"GST","price":"0.50"},{"rate":0.08,"title":"Tax","price":"0.80"}],"tags":"","note_attributes":[],"total_price":"11.30","subtotal_price":"10.00","total_tax":"1.30","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"20.00","currency_code":"USD"},"presentment_money":{"amount":"20.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"11.30","currency_code":"USD"},"presentment_money":{"amount":"11.30","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"1.30","currency_code":"USD"},"presentment_money":{"amount":"1.30","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"11.30","currency_code":"USD"},"presentment_money":{"amount":"11.30","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/1069920477"}}
```
* #### Create a simple draft order with only a product variant ID.
#####
```curl
curl -d '{"draft_order":{"line_items":[{"variant_id":447654529,"quantity":1}]}}' \
-X POST "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```
#####
```remix
const { admin, session } = await authenticate.admin(request);
const draft_order = new admin.rest.resources.DraftOrder({session: session});
draft_order.line_items = [
{
"variant_id": 447654529,
"quantity": 1
}
];
await draft_order.save({
update: true,
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
draft_order = ShopifyAPI::DraftOrder.new(session: test_session)
draft_order.line_items = [
{
"variant_id" => 447654529,
"quantity" => 1
}
]
draft_order.save!
```
#####
```node
// Session is built by the OAuth process
const draft_order = new shopify.rest.DraftOrder({session: session});
draft_order.line_items = [
{
"variant_id": 447654529,
"quantity": 1
}
];
await draft_order.save({
update: true,
});
```
#### response
```json
HTTP/1.1 201 Created{"draft_order":{"id":1069920476,"note":null,"email":null,"taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:55:10-04:00","updated_at":"2025-10-01T14:55:10-04:00","tax_exempt":false,"completed_at":null,"name":"#D3","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":1066630382,"variant_id":447654529,"product_id":921728736,"title":"IPod Touch 8GB","variant_title":"Black","sku":"IPOD2009BLACK","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.05,"title":"GST","price":"9.95"},{"rate":0.08,"title":"Tax","price":"15.92"}],"applied_discount":null,"name":"IPod Touch 8GB - Black","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/1066630382"}],"api_client_id":755357713,"shipping_address":null,"billing_address":null,"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/fcf0789a5d7a3085068aaab4a24163c4","created_on_api_version_handle":"unstable","applied_discount":null,"order_id":null,"shipping_line":null,"tax_lines":[{"rate":0.05,"title":"GST","price":"9.95"},{"rate":0.08,"title":"Tax","price":"15.92"}],"tags":"","note_attributes":[],"total_price":"224.87","subtotal_price":"199.00","total_tax":"25.87","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"224.87","currency_code":"USD"},"presentment_money":{"amount":"224.87","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"25.87","currency_code":"USD"},"presentment_money":{"amount":"25.87","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"224.87","currency_code":"USD"},"presentment_money":{"amount":"224.87","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/1069920476"}}
```
***
## postSend an invoice
[](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderInvoiceSend?example=send-an-invoice)
[draftOrderInvoiceSend](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderInvoiceSend?example=send-an-invoice)
Sends an invoice for the draft order.
You can include the following parameters in the body of the request:
* **draft\_order\_invoice**: The resource to send in the body of the request.
* **to**: The email address that will populate the **to** field of the email.
* **from**: The email address that will populate the **from** field of the email.
* **bcc**: The list of email addresses to include in the **bcc** field of the email. Emails must be associated with staff accounts on the shop.
* **subject**: The email subject.
* **custom\_message**: The custom message displayed in the email.
### Parameters
***
api\_version
string
required
***
draft\_order\_id
string
required
***
### Examples
Send a customized invoice
Path parameters
draft\_order\_id=994118539
string
required
Send the default invoice
Path parameters
draft\_order\_id=994118539
string
required
post
## /admin/api/2025-10/draft\_orders/994118539/send\_invoice.json
```bash
curl -d '{"draft_order_invoice":{"to":"first@example.com","from":"j.smith@example.com","bcc":["j.smith@example.com"],"subject":"Apple Computer Invoice","custom_message":"Thank you for ordering!"}}' \
-X POST "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/994118539/send_invoice.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```
{}
## Response
JSON
```json
HTTP/1.1 201 Created
{
"draft_order_invoice": {
"to": "first@example.com",
"from": "j.smith@example.com",
"subject": "Apple Computer Invoice",
"custom_message": "Thank you for ordering!",
"bcc": [
"j.smith@example.com"
]
}
}
```
### examples
* #### Send a customized invoice
#####
```curl
curl -d '{"draft_order_invoice":{"to":"first@example.com","from":"j.smith@example.com","bcc":["j.smith@example.com"],"subject":"Apple Computer Invoice","custom_message":"Thank you for ordering!"}}' \
-X POST "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/994118539/send_invoice.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```
#####
```remix
const { admin, session } = await authenticate.admin(request);
const draft_order = new admin.rest.resources.DraftOrder({session: session});
draft_order.id = 994118539;
await draft_order.send_invoice({
body: {"draft_order_invoice": {"to": "first@example.com", "from": "j.smith@example.com", "bcc": ["j.smith@example.com"], "subject": "Apple Computer Invoice", "custom_message": "Thank you for ordering!"}},
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
draft_order = ShopifyAPI::DraftOrder.new(session: test_session)
draft_order.id = 994118539
draft_order.send_invoice(
session: test_session,
body: {"draft_order_invoice" => {"to" => "first@example.com", "from" => "j.smith@example.com", "bcc" => ["j.smith@example.com"], "subject" => "Apple Computer Invoice", "custom_message" => "Thank you for ordering!"}},
)
```
#####
```node
// Session is built by the OAuth process
const draft_order = new shopify.rest.DraftOrder({session: session});
draft_order.id = 994118539;
await draft_order.send_invoice({
body: {"draft_order_invoice": {"to": "first@example.com", "from": "j.smith@example.com", "bcc": ["j.smith@example.com"], "subject": "Apple Computer Invoice", "custom_message": "Thank you for ordering!"}},
});
```
#### response
```json
HTTP/1.1 201 Created{"draft_order_invoice":{"to":"first@example.com","from":"j.smith@example.com","subject":"Apple Computer Invoice","custom_message":"Thank you for ordering!","bcc":["j.smith@example.com"]}}
```
* #### Send the default invoice
#####
```curl
curl -d '{"draft_order_invoice":{}}' \
-X POST "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/994118539/send_invoice.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```
#####
```remix
const { admin, session } = await authenticate.admin(request);
const draft_order = new admin.rest.resources.DraftOrder({session: session});
draft_order.id = 994118539;
await draft_order.send_invoice({
body: {"draft_order_invoice": {}},
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
draft_order = ShopifyAPI::DraftOrder.new(session: test_session)
draft_order.id = 994118539
draft_order.send_invoice(
session: test_session,
body: {"draft_order_invoice" => {}},
)
```
#####
```node
// Session is built by the OAuth process
const draft_order = new shopify.rest.DraftOrder({session: session});
draft_order.id = 994118539;
await draft_order.send_invoice({
body: {"draft_order_invoice": {}},
});
```
#### response
```json
HTTP/1.1 201 Created{"draft_order_invoice":{"to":"bob.norman@mail.example.com","from":"\"John Smith Test Store\" ","subject":"Draft Order #D2","custom_message":"","bcc":[]}}
```
***
## getRetrieves a list of draft orders
[](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrders?example=retrieves-a-list-of-draft-orders)
[draftOrders](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrders?example=retrieves-a-list-of-draft-orders)
Retrieves a list of draft orders. **Note:** This endpoint implements pagination by using links that are provided in the response header. To learn more, refer to [Make paginated requests to the REST Admin API](https://shopify.dev/api/usage/pagination-rest).
### Parameters
***
api\_version
string
required
***
fields
A comma-separated list of fields to include in the response
***
fields
comma-separated list of fields to include in the response
***
ids
Filter by list of IDs
***
limit
≤ 250
default 50
Amount of results
***
since\_id
Restrict results to after the specified ID
***
status
enum
default open
Filter draft orders by their status.
Show status properties
* **open**: All open orders (default)
* **invoice\_sent**: Draft orders for which invoice has been sent to the customer
* **completed**: Draft orders that have been completed and turned into an order
***
updated\_at\_max
Show orders last updated before date (format: 2014-04-25T16:15:47-04:00)
***
updated\_at\_min
Show orders last updated after date (format: 2014-04-25T16:15:47-04:00)
***
### Examples
List all draft orders
Retrieve all draft orders after the specified ID
Query parameters
since\_id=123
Restrict results to after the specified ID
Retrieve all draft orders but show only certain properties
Query parameters
fields=created\_at,id,name,total-price
comma-separated list of fields to include in the response
Retrieve draft orders last updated after 2005-07-31 15:57:11 in the EDT timezone
Query parameters
updated\_at\_min=2005-07-31T15:57:11-04:00
Show orders last updated after date (format: 2014-04-25T16:15:47-04:00)
get
## /admin/api/2025-10/draft\_orders.json
```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders.json" \
-H "X-Shopify-Access-Token: {access_token}"
```
{}
## Response
JSON
```json
HTTP/1.1 200 OK
{
"draft_orders": [
{
"id": 72885271,
"note": "rush order",
"email": "bob.norman@mail.example.com",
"taxes_included": false,
"currency": "USD",
"invoice_sent_at": null,
"created_at": "2025-10-01T14:30:56-04:00",
"updated_at": "2025-10-01T14:30:56-04:00",
"tax_exempt": false,
"completed_at": null,
"name": "#D1",
"allow_discount_codes_in_checkout?": false,
"b2b?": false,
"status": "completed",
"line_items": [
{
"id": 498266019,
"variant_id": 39072856,
"product_id": 632910392,
"title": "IPod Nano - 8GB",
"variant_title": "green",
"sku": "IPOD2008GREEN",
"vendor": "Apple",
"quantity": 2,
"requires_shipping": true,
"taxable": true,
"gift_card": false,
"fulfillment_service": "manual",
"grams": 567,
"tax_lines": [
{
"rate": 0.06,
```
### examples
* #### List all draft orders
#####
```curl
curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders.json" \
-H "X-Shopify-Access-Token: {access_token}"
```
#####
```remix
await admin.rest.resources.DraftOrder.all({
session: session,
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
ShopifyAPI::DraftOrder.all(
session: test_session,
)
```
#####
```node
// Session is built by the OAuth process
await shopify.rest.DraftOrder.all({
session: session,
});
```
#### response
```json
HTTP/1.1 200 OK{"draft_orders":[{"id":72885271,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":null,"name":"#D1","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"completed","line_items":[{"id":498266019,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":2,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"23.88"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/498266019"}],"api_client_id":1354745,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/f945c7e2b158dbb69fa642cb8d79171f","created_on_api_version_handle":null,"applied_discount":null,"order_id":450789469,"shipping_line":{"title":"custom shipping","custom":true,"handle":null,"price":"10.00"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"23.88"}],"tags":"","note_attributes":[],"total_price":"431.88","subtotal_price":"398.00","total_tax":"23.88","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"398.00","currency_code":"USD"},"presentment_money":{"amount":"398.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"431.88","currency_code":"USD"},"presentment_money":{"amount":"431.88","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"398.00","currency_code":"USD"},"presentment_money":{"amount":"398.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"23.88","currency_code":"USD"},"presentment_money":{"amount":"23.88","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/72885271","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}},{"id":622762746,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":null,"name":"#D1","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":466157049,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.94"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/466157049"},{"id":605833968,"variant_id":null,"product_id":null,"title":"IPod Nano Engraving","variant_title":null,"sku":"IPODENGRAVING","vendor":null,"quantity":1,"requires_shipping":false,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":0,"tax_lines":[{"rate":0.06,"title":"Tax","price":"1.80"}],"applied_discount":null,"name":"IPod Nano Engraving","properties":[],"custom":true,"price":"30.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/605833968"},{"id":783764327,"variant_id":457924702,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"black","sku":"IPOD2008BLACK","vendor":"Apple","quantity":3,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"35.82"}],"applied_discount":null,"name":"IPod Nano - 8GB - black","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/783764327"}],"api_client_id":1354745,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/f1df1a91d10a6d7704cf2f0315461api","created_on_api_version_handle":null,"applied_discount":null,"order_id":null,"shipping_line":{"title":"custom shipping","custom":true,"handle":null,"price":"10.00"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"1.80"},{"rate":0.06,"title":"Tax","price":"35.82"},{"rate":0.06,"title":"Tax","price":"11.94"}],"tags":"","note_attributes":[],"total_price":"885.56","subtotal_price":"826.00","total_tax":"49.56","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"826.00","currency_code":"USD"},"presentment_money":{"amount":"826.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"885.56","currency_code":"USD"},"presentment_money":{"amount":"885.56","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"826.00","currency_code":"USD"},"presentment_money":{"amount":"826.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"49.56","currency_code":"USD"},"presentment_money":{"amount":"49.56","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/622762746","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}},{"id":691042898,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":"2016-12-31T19:00:00-05:00","created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":"2016-12-31T19:00:00-05:00","name":"#D1","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"completed","line_items":[{"id":158115779,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.94"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/158115779"}],"api_client_id":755357713,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/56dd92fb7adc1a2c38402b1aab15b2f4","created_on_api_version_handle":"unstable","applied_discount":null,"order_id":450789469,"shipping_line":{"title":"custom shipping","custom":true,"handle":null,"price":"10.00"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.94"}],"tags":"","note_attributes":[],"total_price":"220.94","subtotal_price":"199.00","total_tax":"11.94","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"220.94","currency_code":"USD"},"presentment_money":{"amount":"220.94","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"11.94","currency_code":"USD"},"presentment_money":{"amount":"11.94","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/691042898","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}},{"id":994118539,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":null,"name":"#D2","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":994118539,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.64"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/994118539"}],"api_client_id":1354745,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/ba8dcf6c022ccad3d47e3909e378e33f","created_on_api_version_handle":null,"applied_discount":{"description":"$5promo","value":"5.0","title":"$5promo","amount":"5.00","value_type":"fixed_amount"},"order_id":null,"shipping_line":{"title":"UPS Ground","custom":false,"handle":"eyJhbGciOiJIUzI1NiJ9.eyJ0aXRsZSI6IlVQUyBHcm91bmQiLCJjb2RlIjoiMyIsInNvdXJjZSI6InVwcyIsInByaWNlIjoiMTIuMjUiLCJjdXJyZW5jeSI6IlVTRCIsInByaWNlX3ByZXNlbnRtZW50IjoiMTIuMjUiLCJjdXJyZW5jeV9wcmVzZW50bWVudCI6IlVTRCIsImVzdGltYXRlZF9kZWxpdmVyeV90aW1lX3JhbmdlIjpudWxsLCJncm91cF9pZCI6bnVsbH0.5rCkHw9aNgCeQZi3Tf45S-PbW9JJd6PC5ZEapMVgIYY","price":"12.25"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.64"}],"tags":"Wholesale","note_attributes":[],"total_price":"217.89","subtotal_price":"194.00","total_tax":"11.64","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"217.89","currency_code":"USD"},"presentment_money":{"amount":"217.89","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"194.00","currency_code":"USD"},"presentment_money":{"amount":"194.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"11.64","currency_code":"USD"},"presentment_money":{"amount":"11.64","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"5.00","currency_code":"USD"},"presentment_money":{"amount":"5.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"12.25","currency_code":"USD"},"presentment_money":{"amount":"12.25","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/994118539","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}},{"id":1012750869,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":null,"name":"#D2","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":294997122,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.04,"title":"GST","price":"7.96"},{"rate":0.08,"title":"Tax","price":"15.92"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/294997122"}],"api_client_id":1354745,"shipping_address":null,"billing_address":null,"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/f1df1a91d10a6noaddressapi","created_on_api_version_handle":null,"applied_discount":null,"order_id":null,"shipping_line":{"title":"custom shipping","custom":true,"handle":null,"price":"10.00"},"tax_lines":[{"rate":0.04,"title":"GST","price":"7.96"},{"rate":0.08,"title":"Tax","price":"15.92"}],"tags":"","note_attributes":[],"total_price":"232.88","subtotal_price":"199.00","total_tax":"23.88","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"232.88","currency_code":"USD"},"presentment_money":{"amount":"232.88","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"23.88","currency_code":"USD"},"presentment_money":{"amount":"23.88","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/1012750869"}]}
```
* #### Retrieve all draft orders after the specified ID
#####
```curl
curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders.json?since_id=123" \
-H "X-Shopify-Access-Token: {access_token}"
```
#####
```remix
await admin.rest.resources.DraftOrder.all({
session: session,
since_id: "123",
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
ShopifyAPI::DraftOrder.all(
session: test_session,
since_id: "123",
)
```
#####
```node
// Session is built by the OAuth process
await shopify.rest.DraftOrder.all({
session: session,
since_id: "123",
});
```
#### response
```json
HTTP/1.1 200 OK{"draft_orders":[{"id":72885271,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":null,"name":"#D1","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"completed","line_items":[{"id":498266019,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":2,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"23.88"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/498266019"}],"api_client_id":1354745,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/f945c7e2b158dbb69fa642cb8d79171f","created_on_api_version_handle":null,"applied_discount":null,"order_id":450789469,"shipping_line":{"title":"custom shipping","custom":true,"handle":null,"price":"10.00"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"23.88"}],"tags":"","note_attributes":[],"total_price":"431.88","subtotal_price":"398.00","total_tax":"23.88","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"398.00","currency_code":"USD"},"presentment_money":{"amount":"398.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"431.88","currency_code":"USD"},"presentment_money":{"amount":"431.88","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"398.00","currency_code":"USD"},"presentment_money":{"amount":"398.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"23.88","currency_code":"USD"},"presentment_money":{"amount":"23.88","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/72885271","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}},{"id":622762746,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":null,"name":"#D1","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":466157049,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.94"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/466157049"},{"id":605833968,"variant_id":null,"product_id":null,"title":"IPod Nano Engraving","variant_title":null,"sku":"IPODENGRAVING","vendor":null,"quantity":1,"requires_shipping":false,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":0,"tax_lines":[{"rate":0.06,"title":"Tax","price":"1.80"}],"applied_discount":null,"name":"IPod Nano Engraving","properties":[],"custom":true,"price":"30.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/605833968"},{"id":783764327,"variant_id":457924702,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"black","sku":"IPOD2008BLACK","vendor":"Apple","quantity":3,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"35.82"}],"applied_discount":null,"name":"IPod Nano - 8GB - black","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/783764327"}],"api_client_id":1354745,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/f1df1a91d10a6d7704cf2f0315461api","created_on_api_version_handle":null,"applied_discount":null,"order_id":null,"shipping_line":{"title":"custom shipping","custom":true,"handle":null,"price":"10.00"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"1.80"},{"rate":0.06,"title":"Tax","price":"35.82"},{"rate":0.06,"title":"Tax","price":"11.94"}],"tags":"","note_attributes":[],"total_price":"885.56","subtotal_price":"826.00","total_tax":"49.56","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"826.00","currency_code":"USD"},"presentment_money":{"amount":"826.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"885.56","currency_code":"USD"},"presentment_money":{"amount":"885.56","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"826.00","currency_code":"USD"},"presentment_money":{"amount":"826.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"49.56","currency_code":"USD"},"presentment_money":{"amount":"49.56","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/622762746","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}},{"id":691042898,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":"2016-12-31T19:00:00-05:00","created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":"2016-12-31T19:00:00-05:00","name":"#D1","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"completed","line_items":[{"id":158115779,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.94"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/158115779"}],"api_client_id":755357713,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/56dd92fb7adc1a2c38402b1aab15b2f4","created_on_api_version_handle":"unstable","applied_discount":null,"order_id":450789469,"shipping_line":{"title":"custom shipping","custom":true,"handle":null,"price":"10.00"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.94"}],"tags":"","note_attributes":[],"total_price":"220.94","subtotal_price":"199.00","total_tax":"11.94","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"220.94","currency_code":"USD"},"presentment_money":{"amount":"220.94","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"11.94","currency_code":"USD"},"presentment_money":{"amount":"11.94","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/691042898","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}},{"id":994118539,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":null,"name":"#D2","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":994118539,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.64"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/994118539"}],"api_client_id":1354745,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/ba8dcf6c022ccad3d47e3909e378e33f","created_on_api_version_handle":null,"applied_discount":{"description":"$5promo","value":"5.0","title":"$5promo","amount":"5.00","value_type":"fixed_amount"},"order_id":null,"shipping_line":{"title":"UPS Ground","custom":false,"handle":"eyJhbGciOiJIUzI1NiJ9.eyJ0aXRsZSI6IlVQUyBHcm91bmQiLCJjb2RlIjoiMyIsInNvdXJjZSI6InVwcyIsInByaWNlIjoiMTIuMjUiLCJjdXJyZW5jeSI6IlVTRCIsInByaWNlX3ByZXNlbnRtZW50IjoiMTIuMjUiLCJjdXJyZW5jeV9wcmVzZW50bWVudCI6IlVTRCIsImVzdGltYXRlZF9kZWxpdmVyeV90aW1lX3JhbmdlIjpudWxsLCJncm91cF9pZCI6bnVsbH0.5rCkHw9aNgCeQZi3Tf45S-PbW9JJd6PC5ZEapMVgIYY","price":"12.25"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.64"}],"tags":"Wholesale","note_attributes":[],"total_price":"217.89","subtotal_price":"194.00","total_tax":"11.64","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"217.89","currency_code":"USD"},"presentment_money":{"amount":"217.89","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"194.00","currency_code":"USD"},"presentment_money":{"amount":"194.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"11.64","currency_code":"USD"},"presentment_money":{"amount":"11.64","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"5.00","currency_code":"USD"},"presentment_money":{"amount":"5.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"12.25","currency_code":"USD"},"presentment_money":{"amount":"12.25","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/994118539","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}},{"id":1012750869,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":null,"name":"#D2","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":294997122,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.04,"title":"GST","price":"7.96"},{"rate":0.08,"title":"Tax","price":"15.92"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/294997122"}],"api_client_id":1354745,"shipping_address":null,"billing_address":null,"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/f1df1a91d10a6noaddressapi","created_on_api_version_handle":null,"applied_discount":null,"order_id":null,"shipping_line":{"title":"custom shipping","custom":true,"handle":null,"price":"10.00"},"tax_lines":[{"rate":0.04,"title":"GST","price":"7.96"},{"rate":0.08,"title":"Tax","price":"15.92"}],"tags":"","note_attributes":[],"total_price":"232.88","subtotal_price":"199.00","total_tax":"23.88","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"232.88","currency_code":"USD"},"presentment_money":{"amount":"232.88","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"23.88","currency_code":"USD"},"presentment_money":{"amount":"23.88","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/1012750869"}]}
```
* #### Retrieve all draft orders but show only certain properties
#####
```curl
curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders.json?fields=created_at%2Cid%2Cname%2Ctotal-price" \
-H "X-Shopify-Access-Token: {access_token}"
```
#####
```remix
await admin.rest.resources.DraftOrder.all({
session: session,
fields: "created_at,id,name,total-price",
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
ShopifyAPI::DraftOrder.all(
session: test_session,
fields: "created_at,id,name,total-price",
)
```
#####
```node
// Session is built by the OAuth process
await shopify.rest.DraftOrder.all({
session: session,
fields: "created_at,id,name,total-price",
});
```
#### response
```json
HTTP/1.1 200 OK{"draft_orders":[{"id":72885271,"created_at":"2025-10-01T14:30:56-04:00","name":"#D1","total_price":"431.88"},{"id":622762746,"created_at":"2025-10-01T14:30:56-04:00","name":"#D1","total_price":"885.56"},{"id":691042898,"created_at":"2025-10-01T14:30:56-04:00","name":"#D1","total_price":"220.94"},{"id":994118539,"created_at":"2025-10-01T14:30:56-04:00","name":"#D2","total_price":"217.89"},{"id":1012750869,"created_at":"2025-10-01T14:30:56-04:00","name":"#D2","total_price":"232.88"}]}
```
* #### Retrieve draft orders last updated after 2005-07-31 15:57:11 in the EDT timezone
#####
```curl
curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders.json?updated_at_min=2005-07-31T15%3A57%3A11-04%3A00" \
-H "X-Shopify-Access-Token: {access_token}"
```
#####
```remix
await admin.rest.resources.DraftOrder.all({
session: session,
updated_at_min: "2005-07-31T15:57:11-04:00",
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
ShopifyAPI::DraftOrder.all(
session: test_session,
updated_at_min: "2005-07-31T15:57:11-04:00",
)
```
#####
```node
// Session is built by the OAuth process
await shopify.rest.DraftOrder.all({
session: session,
updated_at_min: "2005-07-31T15:57:11-04:00",
});
```
#### response
```json
HTTP/1.1 200 OK{"draft_orders":[{"id":72885271,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":null,"name":"#D1","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"completed","line_items":[{"id":498266019,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":2,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"23.88"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/498266019"}],"api_client_id":1354745,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/f945c7e2b158dbb69fa642cb8d79171f","created_on_api_version_handle":null,"applied_discount":null,"order_id":450789469,"shipping_line":{"title":"custom shipping","custom":true,"handle":null,"price":"10.00"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"23.88"}],"tags":"","note_attributes":[],"total_price":"431.88","subtotal_price":"398.00","total_tax":"23.88","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"398.00","currency_code":"USD"},"presentment_money":{"amount":"398.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"431.88","currency_code":"USD"},"presentment_money":{"amount":"431.88","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"398.00","currency_code":"USD"},"presentment_money":{"amount":"398.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"23.88","currency_code":"USD"},"presentment_money":{"amount":"23.88","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/72885271","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}},{"id":622762746,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":null,"name":"#D1","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":466157049,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.94"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/466157049"},{"id":605833968,"variant_id":null,"product_id":null,"title":"IPod Nano Engraving","variant_title":null,"sku":"IPODENGRAVING","vendor":null,"quantity":1,"requires_shipping":false,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":0,"tax_lines":[{"rate":0.06,"title":"Tax","price":"1.80"}],"applied_discount":null,"name":"IPod Nano Engraving","properties":[],"custom":true,"price":"30.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/605833968"},{"id":783764327,"variant_id":457924702,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"black","sku":"IPOD2008BLACK","vendor":"Apple","quantity":3,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"35.82"}],"applied_discount":null,"name":"IPod Nano - 8GB - black","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/783764327"}],"api_client_id":1354745,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/f1df1a91d10a6d7704cf2f0315461api","created_on_api_version_handle":null,"applied_discount":null,"order_id":null,"shipping_line":{"title":"custom shipping","custom":true,"handle":null,"price":"10.00"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"1.80"},{"rate":0.06,"title":"Tax","price":"35.82"},{"rate":0.06,"title":"Tax","price":"11.94"}],"tags":"","note_attributes":[],"total_price":"885.56","subtotal_price":"826.00","total_tax":"49.56","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"826.00","currency_code":"USD"},"presentment_money":{"amount":"826.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"885.56","currency_code":"USD"},"presentment_money":{"amount":"885.56","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"826.00","currency_code":"USD"},"presentment_money":{"amount":"826.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"49.56","currency_code":"USD"},"presentment_money":{"amount":"49.56","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/622762746","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}},{"id":691042898,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":"2016-12-31T19:00:00-05:00","created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":"2016-12-31T19:00:00-05:00","name":"#D1","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"completed","line_items":[{"id":158115779,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.94"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/158115779"}],"api_client_id":755357713,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/56dd92fb7adc1a2c38402b1aab15b2f4","created_on_api_version_handle":"unstable","applied_discount":null,"order_id":450789469,"shipping_line":{"title":"custom shipping","custom":true,"handle":null,"price":"10.00"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.94"}],"tags":"","note_attributes":[],"total_price":"220.94","subtotal_price":"199.00","total_tax":"11.94","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"220.94","currency_code":"USD"},"presentment_money":{"amount":"220.94","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"11.94","currency_code":"USD"},"presentment_money":{"amount":"11.94","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/691042898","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}},{"id":994118539,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":null,"name":"#D2","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":994118539,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.64"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/994118539"}],"api_client_id":1354745,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/ba8dcf6c022ccad3d47e3909e378e33f","created_on_api_version_handle":null,"applied_discount":{"description":"$5promo","value":"5.0","title":"$5promo","amount":"5.00","value_type":"fixed_amount"},"order_id":null,"shipping_line":{"title":"UPS Ground","custom":false,"handle":"eyJhbGciOiJIUzI1NiJ9.eyJ0aXRsZSI6IlVQUyBHcm91bmQiLCJjb2RlIjoiMyIsInNvdXJjZSI6InVwcyIsInByaWNlIjoiMTIuMjUiLCJjdXJyZW5jeSI6IlVTRCIsInByaWNlX3ByZXNlbnRtZW50IjoiMTIuMjUiLCJjdXJyZW5jeV9wcmVzZW50bWVudCI6IlVTRCIsImVzdGltYXRlZF9kZWxpdmVyeV90aW1lX3JhbmdlIjpudWxsLCJncm91cF9pZCI6bnVsbH0.5rCkHw9aNgCeQZi3Tf45S-PbW9JJd6PC5ZEapMVgIYY","price":"12.25"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.64"}],"tags":"Wholesale","note_attributes":[],"total_price":"217.89","subtotal_price":"194.00","total_tax":"11.64","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"217.89","currency_code":"USD"},"presentment_money":{"amount":"217.89","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"194.00","currency_code":"USD"},"presentment_money":{"amount":"194.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"11.64","currency_code":"USD"},"presentment_money":{"amount":"11.64","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"5.00","currency_code":"USD"},"presentment_money":{"amount":"5.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"12.25","currency_code":"USD"},"presentment_money":{"amount":"12.25","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/994118539","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}},{"id":1012750869,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":null,"name":"#D2","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":294997122,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.04,"title":"GST","price":"7.96"},{"rate":0.08,"title":"Tax","price":"15.92"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/294997122"}],"api_client_id":1354745,"shipping_address":null,"billing_address":null,"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/f1df1a91d10a6noaddressapi","created_on_api_version_handle":null,"applied_discount":null,"order_id":null,"shipping_line":{"title":"custom shipping","custom":true,"handle":null,"price":"10.00"},"tax_lines":[{"rate":0.04,"title":"GST","price":"7.96"},{"rate":0.08,"title":"Tax","price":"15.92"}],"tags":"","note_attributes":[],"total_price":"232.88","subtotal_price":"199.00","total_tax":"23.88","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"232.88","currency_code":"USD"},"presentment_money":{"amount":"232.88","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"23.88","currency_code":"USD"},"presentment_money":{"amount":"23.88","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/1012750869"}]}
```
***
## getReceive a single DraftOrder
[](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrder?example=receive-a-single-draftorder)
[draftOrder](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrder?example=receive-a-single-draftorder)
Retrieves a specific draft order
### Parameters
***
api\_version
string
required
***
draft\_order\_id
string
required
***
fields
A comma-separated list of fields to include in the response
***
### Examples
Get a representation of a single draft order
Path parameters
draft\_order\_id=994118539
string
required
get
## /admin/api/2025-10/draft\_orders/994118539.json
```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/994118539.json" \
-H "X-Shopify-Access-Token: {access_token}"
```
{}
## Response
JSON
```json
HTTP/1.1 200 OK
{
"draft_order": {
"id": 994118539,
"note": "rush order",
"email": "bob.norman@mail.example.com",
"taxes_included": false,
"currency": "USD",
"invoice_sent_at": null,
"created_at": "2025-10-01T14:30:56-04:00",
"updated_at": "2025-10-01T14:30:56-04:00",
"tax_exempt": false,
"completed_at": null,
"name": "#D2",
"allow_discount_codes_in_checkout?": false,
"b2b?": false,
"status": "open",
"line_items": [
{
"id": 994118539,
"variant_id": 39072856,
"product_id": 632910392,
"title": "IPod Nano - 8GB",
"variant_title": "green",
"sku": "IPOD2008GREEN",
"vendor": "Apple",
"quantity": 1,
"requires_shipping": true,
"taxable": true,
"gift_card": false,
"fulfillment_service": "manual",
"grams": 567,
"tax_lines": [
{
"rate": 0.06,
"title": "Tax",
```
### examples
* #### Get a representation of a single draft order
#####
```curl
curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/994118539.json" \
-H "X-Shopify-Access-Token: {access_token}"
```
#####
```remix
await admin.rest.resources.DraftOrder.find({
session: session,
id: 994118539,
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
ShopifyAPI::DraftOrder.find(
session: test_session,
id: 994118539,
)
```
#####
```node
// Session is built by the OAuth process
await shopify.rest.DraftOrder.find({
session: session,
id: 994118539,
});
```
#### response
```json
HTTP/1.1 200 OK{"draft_order":{"id":994118539,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","tax_exempt":false,"completed_at":null,"name":"#D2","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":994118539,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.64"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/994118539"}],"api_client_id":1354745,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/ba8dcf6c022ccad3d47e3909e378e33f","created_on_api_version_handle":null,"applied_discount":{"description":"$5promo","value":"5.0","title":"$5promo","amount":"5.00","value_type":"fixed_amount"},"order_id":null,"shipping_line":{"title":"UPS Ground","custom":false,"handle":"eyJhbGciOiJIUzI1NiJ9.eyJ0aXRsZSI6IlVQUyBHcm91bmQiLCJjb2RlIjoiMyIsInNvdXJjZSI6InVwcyIsInByaWNlIjoiMTIuMjUiLCJjdXJyZW5jeSI6IlVTRCIsInByaWNlX3ByZXNlbnRtZW50IjoiMTIuMjUiLCJjdXJyZW5jeV9wcmVzZW50bWVudCI6IlVTRCIsImVzdGltYXRlZF9kZWxpdmVyeV90aW1lX3JhbmdlIjpudWxsLCJncm91cF9pZCI6bnVsbH0.5rCkHw9aNgCeQZi3Tf45S-PbW9JJd6PC5ZEapMVgIYY","price":"12.25"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.64"}],"tags":"Wholesale","note_attributes":[],"total_price":"217.89","subtotal_price":"194.00","total_tax":"11.64","payment_terms":null,"admin_graphql_api_id":"gid://shopify/DraftOrder/994118539","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}}}
```
***
## getReceive a count of all DraftOrders
[](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrdersCount)
[draftOrdersCount](https://shopify.dev/docs/api/admin-graphql/latest/queries/draftOrdersCount)
Retrieves a count of draft orders
### Parameters
***
api\_version
string
required
***
since\_id
Count draft orders after the specified ID.
***
status
default open
Count draft orders that have a given status.
Show status properties
* **open**: All open orders (default)
* **invoice\_sent**: Draft orders for which invoice has been sent to the customer
* **completed**: Draft orders that have been completed and turned into an order
***
updated\_at\_max
Count draft orders last updated before the specified date (format: 2014-04-25T16:15:47-04:00).
***
updated\_at\_min
Count draft orders last updated after the specified date (format: 2014-04-25T16:15:47-04:00).
***
### Examples
Count all draft orders
get
## /admin/api/2025-10/draft\_orders/count.json
```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/count.json" \
-H "X-Shopify-Access-Token: {access_token}"
```
{}
## Response
JSON
```json
HTTP/1.1 200 OK
{
"count": 5
}
```
### examples
* #### Count all draft orders
#####
```curl
curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/count.json" \
-H "X-Shopify-Access-Token: {access_token}"
```
#####
```remix
await admin.rest.resources.DraftOrder.count({
session: session,
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
ShopifyAPI::DraftOrder.count(
session: test_session,
)
```
#####
```node
// Session is built by the OAuth process
await shopify.rest.DraftOrder.count({
session: session,
});
```
#### response
```json
HTTP/1.1 200 OK{"count":5}
```
***
## putModify an existing DraftOrder
[](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderUpdate?example=modify-an-existing-draftorder)
[draftOrderUpdate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderUpdate?example=modify-an-existing-draftorder)
Updates a draft order.
All non read-only properties of the [DraftOrder Resource](#resource-object) can be edited.
Caution
If a checkout has been started for a draft order, any update to the draft will unlink the checkout. Checkouts are created but not immediately completed when opening the merchant credit card modal in the admin, and when a buyer opens the invoice URL. This is usually fine, but there is an edge case where a checkout is in progress and the draft is updated before the checkout completes. This will not interfere with the checkout and order creation, but if the link from draft to checkout is broken the draft will remain open even after the order is created.
### Parameters
***
api\_version
string
required
***
draft\_order\_id
string
required
***
### Examples
Set a discount on a draft order
Path parameters
draft\_order\_id=994118539
string
required
Request body
draft\_order[](https://shopify.dev/apps/store/data-protection/protected-customer-data)
Draft\_order resource
Show draft\_order properties
draft\_order.id:994118539
read-only
The ID of the draft order.
draft\_order.applied\_discount:{"description":"Custom discount","value\_type":"percentage","value":"10.0","amount":"19.90","title":"Custom"}
->
[](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-appliedDiscount)
[appliedDiscount](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-appliedDiscount)
The discount applied to the line item or the draft order resource. Each draft order resource can have one `applied_discount` resource and each draft order line item can have its own `applied_discount`. The `applied_discount` resource has the following properties:
Show applied\_discount properties
* **title**: Title of the discount.
* **description**: Reason for the discount.
* **value**: The value of the discount. If the type of discount is `fixed_amount`, then it corresponds to a fixed dollar amount. If the type is `percentage`, then it corresponds to percentage.
* **value\_type**: The type of discount. Valid values: `percentage`, `fixed_amount`.
* **amount**: The applied amount of the discount, based on the setting of `value_type`. For more information, see [*Applying discounts*](#applying-discounts).
Add a note to a draft order
Path parameters
draft\_order\_id=994118539
string
required
Request body
draft\_order[](https://shopify.dev/apps/store/data-protection/protected-customer-data)
Draft\_order resource
Show draft\_order properties
draft\_order.id:994118539
read-only
The ID of the draft order.
draft\_order.note:"Customer contacted us about a custom engraving on this iPod"
->
[](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-note)
[note](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-note)
The text of an optional note that a merchant can attach to the draft order.
Change a line item on a draft order
Path parameters
draft\_order\_id=994118539
string
required
Request body
draft\_order[](https://shopify.dev/apps/store/data-protection/protected-customer-data)
Draft\_order resource
Show draft\_order properties
draft\_order.id:994118539
read-only
The ID of the draft order.
draft\_order.line\_items:\[{"variant\_id":447654529,"quantity":1}]
->
[](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
[lineItems](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DraftOrderInput#fields-lineItems)
The product variant line item or custom line item associated to the draft order. Each draft order must include at least one `line_item`. Note that Draft orders don't currently support subscriptions. Each `line_item` resource has the following properties:
Show line\_items properties
* **custom**: *Read only field* Whether this is a custom line item or a product variant line item. If set to `true` indicates a custom line item. If set to `false` indicates a product variant line item.
* **id**: The ID of the line item.
* **variant\_id**: The ID of the product variant corresponding to the line item. Required for a product variant line item. Set to `null` for a custom line item.
* **product\_id**: The ID of the product corresponding to the line item’s product variant.
* **name**: The name of the product.
* **variant\_title**: The title of the product variant. Defaults to `Custom` for custom line items created via the API.
* **vendor**: The vendor.
* **quantity**: The number of products that were purchased.
* **gift\_card**: Indicates if the product is a gift card. Valid values: `true` or `false`.
* **fulfillment\_service**: The service provider responsible for fulfillment. Valid values are either `manual` or the name of the provider, for example amazon, shipwire. Defaults to `manual` for custom line items.
* **properties**: An array of custom information for an item that has been added to the draft order, often used to provide [product customization options](https://shopify.dev/api/liquid/objects/line_item#line_item-properties). Copied to created order when draft order is completed.
* **applied\_discount**: The discount applied to the line item. For more information, see the `applied_discount` property.
* **tax\_lines**: *Read only field* The calculated rate and amount of taxes for the line item.
* * **price**: The amount of tax to be charged.
* **rate**: The rate of tax to be applied.
* **title**: The name of the tax.
**title**: The title of the product or variant. Applicable only to custom line items. *Required field*.
* **price**: The price of the item before discounts have been applied. Applicable only to custom line items. *Required field*.
* **grams**: The weight of the item in grams. Applicable only to custom line items. If not specified, defaults to 0.
* **requires\_shipping**: Whether the fulfillment requires shipping. Applicable only to custom line items. Valid values: `true` or `false.`
* **sku**: A unique identifier for the item in the fulfillment. Applicable only to custom line items.
* **taxable**: Whether the product is taxable. Applicable only to custom line items.
put
## /admin/api/2025-10/draft\_orders/994118539.json
```bash
curl -d '{"draft_order":{"id":994118539,"applied_discount":{"description":"Custom discount","value_type":"percentage","value":"10.0","amount":"19.90","title":"Custom"}}}' \
-X PUT "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/994118539.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```
{}
## Response
JSON
```json
HTTP/1.1 200 OK
{
"draft_order": {
"id": 994118539,
"note": "rush order",
"email": "bob.norman@mail.example.com",
"taxes_included": false,
"currency": "USD",
"invoice_sent_at": null,
"created_at": "2025-10-01T14:30:56-04:00",
"updated_at": "2025-10-01T14:55:12-04:00",
"tax_exempt": false,
"completed_at": null,
"name": "#D2",
"allow_discount_codes_in_checkout?": false,
"b2b?": false,
"status": "open",
"line_items": [
{
"id": 994118539,
"variant_id": 39072856,
"product_id": 632910392,
"title": "IPod Nano - 8GB",
"variant_title": "green",
"sku": "IPOD2008GREEN",
"vendor": "Apple",
"quantity": 1,
"requires_shipping": true,
"taxable": true,
"gift_card": false,
"fulfillment_service": "manual",
"grams": 567,
"tax_lines": [
{
"rate": 0.06,
"title": "Tax",
```
### examples
* #### \Set a discount on a draft order\
#####
```curl
curl -d '{"draft_order":{"id":994118539,"applied_discount":{"description":"Custom discount","value_type":"percentage","value":"10.0","amount":"19.90","title":"Custom"}}}' \
-X PUT "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/994118539.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```
#####
```remix
const { admin, session } = await authenticate.admin(request);
const draft_order = new admin.rest.resources.DraftOrder({session: session});
draft_order.id = 994118539;
draft_order.applied_discount = {
"description": "Custom discount",
"value_type": "percentage",
"value": "10.0",
"amount": "19.90",
"title": "Custom"
};
await draft_order.save({
update: true,
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
draft_order = ShopifyAPI::DraftOrder.new(session: test_session)
draft_order.id = 994118539
draft_order.applied_discount = {
"description" => "Custom discount",
"value_type" => "percentage",
"value" => "10.0",
"amount" => "19.90",
"title" => "Custom"
}
draft_order.save!
```
#####
```node
// Session is built by the OAuth process
const draft_order = new shopify.rest.DraftOrder({session: session});
draft_order.id = 994118539;
draft_order.applied_discount = {
"description": "Custom discount",
"value_type": "percentage",
"value": "10.0",
"amount": "19.90",
"title": "Custom"
};
await draft_order.save({
update: true,
});
```
#### response
```json
HTTP/1.1 200 OK{"draft_order":{"id":994118539,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:55:12-04:00","tax_exempt":false,"completed_at":null,"name":"#D2","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":994118539,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"10.75"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/994118539"}],"api_client_id":1354745,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/ba8dcf6c022ccad3d47e3909e378e33f","created_on_api_version_handle":null,"applied_discount":{"description":"Custom discount","value":"10.0","title":"Custom","amount":"19.90","value_type":"percentage"},"order_id":null,"shipping_line":{"title":"UPS Ground","custom":true,"handle":null,"price":"12.25"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"10.75"}],"tags":"Wholesale","note_attributes":[],"total_price":"202.10","subtotal_price":"179.10","total_tax":"10.75","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"202.10","currency_code":"USD"},"presentment_money":{"amount":"202.10","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"179.10","currency_code":"USD"},"presentment_money":{"amount":"179.10","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"10.75","currency_code":"USD"},"presentment_money":{"amount":"10.75","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"19.90","currency_code":"USD"},"presentment_money":{"amount":"19.90","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"12.25","currency_code":"USD"},"presentment_money":{"amount":"12.25","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"202.10","currency_code":"USD"},"presentment_money":{"amount":"202.10","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/994118539","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}}}
```
* #### Add a note to a draft order
#####
```curl
curl -d '{"draft_order":{"id":994118539,"note":"Customer contacted us about a custom engraving on this iPod"}}' \
-X PUT "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/994118539.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```
#####
```remix
const { admin, session } = await authenticate.admin(request);
const draft_order = new admin.rest.resources.DraftOrder({session: session});
draft_order.id = 994118539;
draft_order.note = "Customer contacted us about a custom engraving on this iPod";
await draft_order.save({
update: true,
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
draft_order = ShopifyAPI::DraftOrder.new(session: test_session)
draft_order.id = 994118539
draft_order.note = "Customer contacted us about a custom engraving on this iPod"
draft_order.save!
```
#####
```node
// Session is built by the OAuth process
const draft_order = new shopify.rest.DraftOrder({session: session});
draft_order.id = 994118539;
draft_order.note = "Customer contacted us about a custom engraving on this iPod";
await draft_order.save({
update: true,
});
```
#### response
```json
HTTP/1.1 200 OK{"draft_order":{"id":994118539,"note":"Customer contacted us about a custom engraving on this iPod","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:55:09-04:00","tax_exempt":false,"completed_at":null,"name":"#D2","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":994118539,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.64"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/994118539"}],"api_client_id":1354745,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/ba8dcf6c022ccad3d47e3909e378e33f","created_on_api_version_handle":null,"applied_discount":{"description":"$5promo","value":"5.0","title":"$5promo","amount":"5.00","value_type":"fixed_amount"},"order_id":null,"shipping_line":{"title":"UPS Ground","custom":true,"handle":null,"price":"12.25"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.64"}],"tags":"Wholesale","note_attributes":[],"total_price":"217.89","subtotal_price":"194.00","total_tax":"11.64","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"217.89","currency_code":"USD"},"presentment_money":{"amount":"217.89","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"194.00","currency_code":"USD"},"presentment_money":{"amount":"194.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"11.64","currency_code":"USD"},"presentment_money":{"amount":"11.64","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"5.00","currency_code":"USD"},"presentment_money":{"amount":"5.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"12.25","currency_code":"USD"},"presentment_money":{"amount":"12.25","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"217.89","currency_code":"USD"},"presentment_money":{"amount":"217.89","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/994118539","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}}}
```
* #### Change a line item on a draft order
#####
```curl
curl -d '{"draft_order":{"id":994118539,"line_items":[{"variant_id":447654529,"quantity":1}]}}' \
-X PUT "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/994118539.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```
#####
```remix
const { admin, session } = await authenticate.admin(request);
const draft_order = new admin.rest.resources.DraftOrder({session: session});
draft_order.id = 994118539;
draft_order.line_items = [
{
"variant_id": 447654529,
"quantity": 1
}
];
await draft_order.save({
update: true,
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
draft_order = ShopifyAPI::DraftOrder.new(session: test_session)
draft_order.id = 994118539
draft_order.line_items = [
{
"variant_id" => 447654529,
"quantity" => 1
}
]
draft_order.save!
```
#####
```node
// Session is built by the OAuth process
const draft_order = new shopify.rest.DraftOrder({session: session});
draft_order.id = 994118539;
draft_order.line_items = [
{
"variant_id": 447654529,
"quantity": 1
}
];
await draft_order.save({
update: true,
});
```
#### response
```json
HTTP/1.1 200 OK{"draft_order":{"id":994118539,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:54:58-04:00","tax_exempt":false,"completed_at":null,"name":"#D2","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"open","line_items":[{"id":1066630380,"variant_id":447654529,"product_id":921728736,"title":"IPod Touch 8GB","variant_title":"Black","sku":"IPOD2009BLACK","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.64"}],"applied_discount":null,"name":"IPod Touch 8GB - Black","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/1066630380"}],"api_client_id":1354745,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/ba8dcf6c022ccad3d47e3909e378e33f","created_on_api_version_handle":null,"applied_discount":{"description":"$5promo","value":"5.0","title":"$5promo","amount":"5.00","value_type":"fixed_amount"},"order_id":null,"shipping_line":{"title":"UPS Ground","custom":true,"handle":null,"price":"12.25"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.64"}],"tags":"Wholesale","note_attributes":[],"total_price":"217.89","subtotal_price":"194.00","total_tax":"11.64","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"199.00","currency_code":"USD"},"presentment_money":{"amount":"199.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"217.89","currency_code":"USD"},"presentment_money":{"amount":"217.89","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"194.00","currency_code":"USD"},"presentment_money":{"amount":"194.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"11.64","currency_code":"USD"},"presentment_money":{"amount":"11.64","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"5.00","currency_code":"USD"},"presentment_money":{"amount":"5.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"12.25","currency_code":"USD"},"presentment_money":{"amount":"12.25","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"217.89","currency_code":"USD"},"presentment_money":{"amount":"217.89","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/994118539","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:30:56-04:00","first_name":"Bob","last_name":"Norman","orders_count":1,"state":"disabled","total_spent":"199.65","last_order_id":450789469,"note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"tags":"Léon, Noël","last_order_name":"#1001","email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"email_marketing_consent":{"state":"not_subscribed","opt_in_level":null,"consent_updated_at":"2004-06-13T11:57:11-04:00"},"sms_marketing_consent":{"state":"not_subscribed","opt_in_level":"single_opt_in","consent_updated_at":"2024-01-01T07:00:00-05:00","consent_collected_from":"OTHER"},"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}}}
```
***
## putComplete a draft order
[](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderComplete?example=complete-a-draft-order)
[draftOrderComplete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderComplete?example=complete-a-draft-order)
Completes a draft order.
Using the DraftOrder resource, you can create a draft order and transition it to an order.
The following flows are supported:
* Create a draft order that calculates taxes and totals but accept payment from the customer outside of Shopify.
* Create a draft order and send an invoice to the customer.
### Parameters
***
api\_version
string
required
***
draft\_order\_id
string
required
***
payment\_gateway\_id
Sets the payment gateway ID. For more information, see the [Payments API](https://shopify.dev/docs/api/admin-rest/reference/resources/payment#create-{{%20current_version%20}}}).
***
payment\_pending
Sets payment pending to true or false.
Show payment\_pending properties
* **true**: The resulting order will be unpaid and can be captured later.
* **false**: The resulting order will be marked as paid through either the default or specified gateway.
***
### Examples
Complete a draft order, marking it as paid
Path parameters
draft\_order\_id=622762746
string
required
Complete a draft order, marking it as pending
Path parameters
draft\_order\_id=622762746
string
required
Query parameters
payment\_pending=true
Sets payment pending to true or false.
Show payment\_pending properties
* **true**: The resulting order will be unpaid and can be captured later.
* **false**: The resulting order will be marked as paid through either the default or specified gateway.
put
## /admin/api/2025-10/draft\_orders/622762746/complete.json
```bash
curl -X PUT "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/622762746/complete.json" \
-H "X-Shopify-Access-Token: {access_token}"
```
{}
## Response
JSON
```json
HTTP/1.1 200 OK
{
"draft_order": {
"id": 622762746,
"note": "rush order",
"email": "bob.norman@mail.example.com",
"taxes_included": false,
"currency": "USD",
"invoice_sent_at": null,
"created_at": "2025-10-01T14:30:56-04:00",
"updated_at": "2025-10-01T14:55:07-04:00",
"tax_exempt": false,
"completed_at": "2025-10-01T14:55:07-04:00",
"name": "#D1",
"allow_discount_codes_in_checkout?": false,
"b2b?": false,
"status": "completed",
"line_items": [
{
"id": 466157049,
"variant_id": 39072856,
"product_id": 632910392,
"title": "IPod Nano - 8GB",
"variant_title": "green",
"sku": "IPOD2008GREEN",
"vendor": "Apple",
"quantity": 1,
"requires_shipping": true,
"taxable": true,
"gift_card": false,
"fulfillment_service": "manual",
"grams": 567,
"tax_lines": [
{
"rate": 0.06,
"title": "Tax",
```
### examples
* #### Complete a draft order, marking it as paid
#####
```curl
curl -X PUT "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/622762746/complete.json" \
-H "X-Shopify-Access-Token: {access_token}"
```
#####
```remix
const { admin, session } = await authenticate.admin(request);
const draft_order = new admin.rest.resources.DraftOrder({session: session});
draft_order.id = 622762746;
await draft_order.complete({});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
draft_order = ShopifyAPI::DraftOrder.new(session: test_session)
draft_order.id = 622762746
draft_order.complete(
session: test_session,
)
```
#####
```node
// Session is built by the OAuth process
const draft_order = new shopify.rest.DraftOrder({session: session});
draft_order.id = 622762746;
await draft_order.complete({});
```
#### response
```json
HTTP/1.1 200 OK{"draft_order":{"id":622762746,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:55:07-04:00","tax_exempt":false,"completed_at":"2025-10-01T14:55:07-04:00","name":"#D1","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"completed","line_items":[{"id":466157049,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.94"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/466157049"},{"id":605833968,"variant_id":null,"product_id":null,"title":"IPod Nano Engraving","variant_title":null,"sku":"IPODENGRAVING","vendor":null,"quantity":1,"requires_shipping":false,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":0,"tax_lines":[{"rate":0.06,"title":"Tax","price":"1.80"}],"applied_discount":null,"name":"IPod Nano Engraving","properties":[],"custom":true,"price":"30.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/605833968"},{"id":783764327,"variant_id":457924702,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"black","sku":"IPOD2008BLACK","vendor":"Apple","quantity":3,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"35.82"}],"applied_discount":null,"name":"IPod Nano - 8GB - black","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/783764327"}],"api_client_id":1354745,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/f1df1a91d10a6d7704cf2f0315461api","created_on_api_version_handle":null,"applied_discount":null,"order_id":1073459963,"shipping_line":{"title":"custom shipping","custom":true,"handle":null,"price":"10.00"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"1.80"},{"rate":0.06,"title":"Tax","price":"35.82"},{"rate":0.06,"title":"Tax","price":"11.94"}],"tags":"","note_attributes":[],"total_price":"885.56","subtotal_price":"826.00","total_tax":"49.56","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"826.00","currency_code":"USD"},"presentment_money":{"amount":"826.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"885.56","currency_code":"USD"},"presentment_money":{"amount":"885.56","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"826.00","currency_code":"USD"},"presentment_money":{"amount":"826.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"49.56","currency_code":"USD"},"presentment_money":{"amount":"49.56","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/622762746","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:55:08-04:00","first_name":"Bob","last_name":"Norman","state":"disabled","note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":1053317288,"customer_id":207119551,"first_name":"Bob","last_name":"Norman","company":null,"address1":"Chestnut Street 92","address2":null,"city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"+1(502)-459-2181","name":"Bob Norman","province_code":"KY","country_code":"US","country_name":"United States","default":true}}}}
```
* #### Complete a draft order, marking it as pending
#####
```curl
curl -X PUT "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/622762746/complete.json?payment_pending=true" \
-H "X-Shopify-Access-Token: {access_token}"
```
#####
```remix
const { admin, session } = await authenticate.admin(request);
const draft_order = new admin.rest.resources.DraftOrder({session: session});
draft_order.id = 622762746;
await draft_order.complete({
payment_pending: "true",
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
draft_order = ShopifyAPI::DraftOrder.new(session: test_session)
draft_order.id = 622762746
draft_order.complete(
session: test_session,
payment_pending: "true",
)
```
#####
```node
// Session is built by the OAuth process
const draft_order = new shopify.rest.DraftOrder({session: session});
draft_order.id = 622762746;
await draft_order.complete({
payment_pending: "true",
});
```
#### response
```json
HTTP/1.1 200 OK{"draft_order":{"id":622762746,"note":"rush order","email":"bob.norman@mail.example.com","taxes_included":false,"currency":"USD","invoice_sent_at":null,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:55:04-04:00","tax_exempt":false,"completed_at":"2025-10-01T14:55:04-04:00","name":"#D1","allow_discount_codes_in_checkout?":false,"b2b?":false,"status":"completed","line_items":[{"id":466157049,"variant_id":39072856,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"green","sku":"IPOD2008GREEN","vendor":"Apple","quantity":1,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"11.94"}],"applied_discount":null,"name":"IPod Nano - 8GB - green","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/466157049"},{"id":605833968,"variant_id":null,"product_id":null,"title":"IPod Nano Engraving","variant_title":null,"sku":"IPODENGRAVING","vendor":null,"quantity":1,"requires_shipping":false,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":0,"tax_lines":[{"rate":0.06,"title":"Tax","price":"1.80"}],"applied_discount":null,"name":"IPod Nano Engraving","properties":[],"custom":true,"price":"30.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/605833968"},{"id":783764327,"variant_id":457924702,"product_id":632910392,"title":"IPod Nano - 8GB","variant_title":"black","sku":"IPOD2008BLACK","vendor":"Apple","quantity":3,"requires_shipping":true,"taxable":true,"gift_card":false,"fulfillment_service":"manual","grams":567,"tax_lines":[{"rate":0.06,"title":"Tax","price":"35.82"}],"applied_discount":null,"name":"IPod Nano - 8GB - black","properties":[],"custom":false,"price":"199.00","admin_graphql_api_id":"gid://shopify/DraftOrderLineItem/783764327"}],"api_client_id":1354745,"shipping_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"billing_address":{"first_name":"Bob","address1":"Chestnut Street 92","phone":"+1(502)-459-2181","city":"Louisville","zip":"40202","province":"Kentucky","country":"United States","last_name":"Norman","address2":"","company":null,"latitude":45.41634,"longitude":-75.6868,"name":"Bob Norman","country_code":"US","province_code":"KY"},"invoice_url":"https://jsmith.myshopify.com/548380009/invoices/f1df1a91d10a6d7704cf2f0315461api","created_on_api_version_handle":null,"applied_discount":null,"order_id":1073459962,"shipping_line":{"title":"custom shipping","custom":true,"handle":null,"price":"10.00"},"tax_lines":[{"rate":0.06,"title":"Tax","price":"1.80"},{"rate":0.06,"title":"Tax","price":"35.82"},{"rate":0.06,"title":"Tax","price":"11.94"}],"tags":"","note_attributes":[],"total_price":"885.56","subtotal_price":"826.00","total_tax":"49.56","payment_terms":null,"presentment_currency":"USD","total_line_items_price_set":{"shop_money":{"amount":"826.00","currency_code":"USD"},"presentment_money":{"amount":"826.00","currency_code":"USD"}},"total_price_set":{"shop_money":{"amount":"885.56","currency_code":"USD"},"presentment_money":{"amount":"885.56","currency_code":"USD"}},"subtotal_price_set":{"shop_money":{"amount":"826.00","currency_code":"USD"},"presentment_money":{"amount":"826.00","currency_code":"USD"}},"total_tax_set":{"shop_money":{"amount":"49.56","currency_code":"USD"},"presentment_money":{"amount":"49.56","currency_code":"USD"}},"total_discounts_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"total_shipping_price_set":{"shop_money":{"amount":"10.00","currency_code":"USD"},"presentment_money":{"amount":"10.00","currency_code":"USD"}},"total_additional_fees_set":null,"total_duties_set":null,"amount_due_now_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"amount_due_later_set":{"shop_money":{"amount":"0.00","currency_code":"USD"},"presentment_money":{"amount":"0.00","currency_code":"USD"}},"admin_graphql_api_id":"gid://shopify/DraftOrder/622762746","customer":{"id":207119551,"created_at":"2025-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:55:04-04:00","first_name":"Bob","last_name":"Norman","state":"disabled","note":null,"verified_email":true,"multipass_identifier":null,"tax_exempt":false,"email":"bob.norman@mail.example.com","phone":"+16136120707","currency":"USD","tax_exemptions":[],"admin_graphql_api_id":"gid://shopify/Customer/207119551","default_address":{"id":1053317287,"customer_id":207119551,"first_name":"Bob","last_name":"Norman","company":null,"address1":"Chestnut Street 92","address2":null,"city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"+1(502)-459-2181","name":"Bob Norman","province_code":"KY","country_code":"US","country_name":"United States","default":true}}}}
```
***
## delRemove an existing DraftOrder
[](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderDelete?example=remove-an-existing-draftorder)
[draftOrderDelete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/draftOrderDelete?example=remove-an-existing-draftorder)
Deletes a draft order
### Parameters
***
api\_version
string
required
***
draft\_order\_id
string
required
***
### Examples
Permanently delete a draft order
Path parameters
draft\_order\_id=994118539
string
required
del
## /admin/api/2025-10/draft\_orders/994118539.json
```bash
curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/994118539.json" \
-H "X-Shopify-Access-Token: {access_token}"
```
{}
## Response
JSON
```json
HTTP/1.1 200 OK
{}
```
### examples
* #### Permanently delete a draft order
#####
```curl
curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2025-10/draft_orders/994118539.json" \
-H "X-Shopify-Access-Token: {access_token}"
```
#####
```remix
await admin.rest.resources.DraftOrder.delete({
session: session,
id: 994118539,
});
```
#####
```ruby
# Session is activated via Authentication
test_session = ShopifyAPI::Context.active_session
ShopifyAPI::DraftOrder.delete(
session: test_session,
id: 994118539,
)
```
#####
```node
// Session is built by the OAuth process
await shopify.rest.DraftOrder.delete({
session: session,
id: 994118539,
});
```
#### response
```json
HTTP/1.1 200 OK{}
```