id "id" : 450789469 The ID of the draft order.

order_id "id" : 456789101 The ID of the order that 's created and associated with the draft order after the draft order is completed.

name "name" : "#1001" Name of the draft order.

customer "customer" : { "id" : 207119551 , "email" : "bob.norman@hostmail.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" : {} } Information about the customer. To load a customer, provide the ID as part of the draft order object in the Create POST request. To remove a customer, set the customer property to null as part of the Create POST request. For more information, see Loading and removing customers. For more information about the customer object, see the Customer resource.

shipping_address "shipping_address" : { "address1" : "123 Amoebobacterieae St" , "address2" : "" , "city" : "Ottawa" , "company" : null , "country" : "Canada" , "first_name" : "Bob" , "last_name" : "Bobsen" , "latitude" : "45.41634" , "longitude" : "-75.6868" , "phone" : "555-625-1199" , "province" : "Ontario" , "zip" : "K2P0V6" , "name" : "Bob Bobsen" , "country_code" : "CA" , "province_code" : "ON" } The mailing address to where the order will be shipped. This address is optional and will not be available on orders that do not require shipping. It has the following properties: address1 : The street address of the shipping address.

: The street address of the shipping address. address2 : An optional additional field for the street address of the shipping address.

: An optional additional field for the street address of the shipping address. city : The city of the shipping address.

: The city of the shipping address. company : The company of the person associated with the shipping address.

: The company of the person associated with the shipping address. country : The name of the country of the shipping address.

: The name of the country of the shipping address. country_code : The two-letter code for the country of the shipping address.

: The two-letter code for the country of the shipping address. first_name : The first name of the person associated with the payment method.

: The first name of the person associated with the payment method. last_name : The last name of the person associated with the payment method.

: The last name of the person associated with the payment method. latitude : The latitude of the shipping address.

: The latitude of the shipping address. longitude : The longitude of the shipping address.

: The longitude of the shipping address. name : The full name of the person associated with the payment method.

: The full name of the person associated with the payment method. phone : The phone number at the shipping address.

: The phone number at the shipping address. province : The name of the state or province of the shipping address.

: The name of the state or province of the shipping address. province_code : The two-letter abbreviation of the state or province of the shipping address.

: The two-letter abbreviation of the state or province of the shipping address. zip: The zip or postal code of the shipping address.

billing_address "billing_address" : { "address1" : "123 Amoebobacterieae St" , "address2" : "" , "city" : "Ottawa" , "company" : null , "country" : "US" , "first_name" : null , "id" : 207119551 , "last_name" : null , "phone" : "(555)555-5555" , "province" : "KY" , "zip" : "40202" , "name" : null , "province_code" : null , "country_code" : null , "default" : true } 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. It has the following properties: address1 : The street address of the billing address.

: The street address of the billing address. address2 : An optional additional field for the street address of the billing address.

: An optional additional field for the street address of the billing address. city : The city of the billing address.

: The city of the billing address. company : The company of the person associated with the billing address.

: The company of the person associated with the billing address. country : The name of the country of the billing address.

: The name of the country of the billing address. country_code : The two-letter code (ISO 3166-1 alpha-2 two-letter country code) for the country of the billing address.

: The two-letter code (ISO 3166-1 alpha-2 two-letter country code) for the country of the billing address. first_name : The first name of the person associated with the payment method.

: The first name of the person associated with the payment method. last_name : The last name of the person associated with the payment method.

: The last name of the person associated with the payment method. latitude : The latitude of the billing address.

: The latitude of the billing address. longitude : The longitude of the billing address.

: The longitude of the billing address. name : The full name of the person associated with the payment method.

: The full name of the person associated with the payment method. phone : The phone number at the billing address.

: The phone number at the billing address. province : The name of the billing address region, such as province, state, or prefecture.

: The name of the billing address region, such as province, state, or prefecture. province_code : The two-letter abbreviation of the region for the billing address.

: The two-letter abbreviation of the region for the billing address. zip: The postal code of the billing address, such as zip, postcode, or Eircode.

note "note" : null The text of an optional note that a shop owner can attach to the draft order.

note_attributes "note_attributes" : [ { "name" : "custom name" , "value" : "custom value" } ] Extra information that is added to the order. Appears in the Additional details section of an order details page. Each array entry must contain a hash with name and value keys.

email "email" : "bob.norman@example.com" The customer's email address.

currency "currency" : "USD" The three letter code (ISO 4217 format) for the currency used for the payment.

invoice_sent_at "invoice_sent_at" : "2008-01-10T11:00:00-05:00" The date and time (ISO 8601 format) when the invoice was emailed to the customer.

invoice_url "invoice_url" : "https://www.example.com/14376108/checkouts/91a9b3f92d7d42e57268eff5ebd570df" The URL for the invoice.

line_items "line_items" : { "custom" : false , "fulfillable_quantity" : 1 , "fulfillment_service" : "amazon" , "grams" : 500 , "id" : 669751112 , "price" : "199.99" , "product_id" : 7513594 , "quantity" : 1 , "requires_shipping" : true , "sku" : "IPOD-342-N" , "title" : "IPod Nano" , "variant_id" : 4264112 , "variant_title" : "Pink" , "vendor" : "Apple" , "name" : "IPod Nano - Pink" , "gift_card" : false , "properties" : [ { "name" : "custom engraving" , "value" : "Happy Birthday Mom!" } ] , "taxable" : true , "tax_lines" : [ { "title" : "title of tax line" , "rate" : "10" , "price" : "18" } ] , "applied_discount" : { "title" : "title of the discount" , "description" : "Description of discount!" , "value" : "10" , "value_type" : "percentage" , "amount" : "19.99" } } Product variant line item or custom line item associated to the draft order. Each draft order must include at least one line_item . Each line_item object has the following 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.

: Whether this is a custom line item or a product variant line item. If set to indicates a custom line item. If set to indicates a product variant line item. id : The ID of the line item.

: The ID of the line item. variant_id : The ID of the product variant ID corresponding to the line item. Required for a product variant line item. Set to null for a custom line item.

: The ID of the product variant ID corresponding to the line item. Required for a product variant line item. Set to for a custom line item. product_id : The ID of the product corresponding to the line item’s product variant.

: The ID of the product corresponding to the line item’s product variant. name : The name of the product.

: The name of the product. variant_title : The title of the product variant. Defaults to Custom for custom line items created via the API.

: The title of the product variant. Defaults to for custom line items created via the API. vendor : Vendor.

: Vendor. quantity : The number of products that were purchased.

: The number of products that were purchased. gift_card : Indicates if the product is a gift card. Valid values are true or false .

: Indicates if the product is a gift card. Valid values are or . fulfillment_service : Service provider responsible for fulfillment. Valid values are either manual or the name of the provider. eg amazon, shipwire, etc. Defaults to manual for custom line items.

: Service provider responsible for fulfillment. Valid values are either or the name of the provider. eg amazon, shipwire, etc. Defaults to 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. Copied to created order when draft order is completed.

: An array of custom information for an item that has been added to the draft order, often used to provide product customization options. Copied to created order when draft order is completed. applied_discount : The discount applied to the line item. For more information, see applied_discount .

: The discount applied to the line item. For more information, see . tax_line : The calculated rate and amount of taxes. For more information, see tax_lines .

: The calculated rate and amount of taxes. For more information, see . title : The title of the product or variant. Only applicable to custom line items. Required field .

: The title of the product or variant. Only applicable to custom line items. . price : The price of the item before discounts have been applied. Only applicable to custom line items. Required field .

: The price of the item before discounts have been applied. Only applicable to custom line items. . grams : Weight in grams. Only applicable to custom line items. If not specified, defaults to 0.

: Weight in grams. Only applicable 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 are true or false.

: Whether the fulfillment requires shipping. Applicable only to custom line items. Valid values are or sku : A unique identifier of the item in the fulfillment. Applicable only to custom line items.

: A unique identifier of the item in the fulfillment. Applicable only to custom line items. taxable: Whether the product is taxable. Only applicable to custom line items.

shipping_line "shipping_line" : { "handle" : "shopify-Standard%20Shipping-8.00" , "price" : 0.0 , "title" : "Free Shipping" } A shipping_line object, which details the shipping method used. The object has the following properties: custom : Whether this is a regular shipping line or custom shipping line.

: Whether this is a regular shipping line or custom shipping line. handle : The handle of the shipping rate which was selected and applied. Required for regular shipping lines.

: The handle of the shipping rate which was selected and applied. Required for regular shipping lines. title : The title of the shipping method. Required for custom shipping lines. (maximum: 255 characters)

: The title of the shipping method. Required for custom shipping lines. (maximum: 255 characters) price: The price of the shipping method. Required for custom shipping lines.

tax_exempt "tax_exempt" : false Whether taxes are exempt for the draft order. If set to false , then Shopify refers to the taxable field for each line_item . If a customer is applied to the draft order, then Shopify uses the customer's tax_exempt field instead.

tax_exemptions "tax_exemptions" : [ "CA_STATUS_CARD_EXEMPTION" , "CA_BC_RESELLER_EXEMPTION" ] Whether the customer is exempt from paying specific taxes on their order. Canadian taxes only. Valid values: EXEMPT_ALL : This customer is exempt from all Canadian taxes.

: This customer is exempt from all Canadian taxes. CA_STATUS_CARD_EXEMPTION : This customer is exempt from specific taxes for holding a valid STATUS_CARD_EXEMPTION in Canada.

: This customer is exempt from specific taxes for holding a valid STATUS_CARD_EXEMPTION in Canada. CA_DIPLOMAT_EXEMPTION : This customer is exempt from specific taxes for holding a valid DIPLOMAT_EXEMPTION in Canada.

: This customer is exempt from specific taxes for holding a valid DIPLOMAT_EXEMPTION in Canada. CA_BC_RESELLER_EXEMPTION : This customer is exempt from specific taxes for holding a valid RESELLER_EXEMPTION in British Columbia.

: This customer is exempt from specific taxes for holding a valid RESELLER_EXEMPTION in British Columbia. CA_MB_RESELLER_EXEMPTION : This customer is exempt from specific taxes for holding a valid RESELLER_EXEMPTION in Manitoba.

: This customer is exempt from specific taxes for holding a valid RESELLER_EXEMPTION in Manitoba. CA_SK_RESELLER_EXEMPTION : This customer is exempt from specific taxes for holding a valid RESELLER_EXEMPTION in Saskatchewan.

: This customer is exempt from specific taxes for holding a valid RESELLER_EXEMPTION in Saskatchewan. CA_BC_COMMERCIAL_FISHERY_EXEMPTION : This customer is exempt from specific taxes for holding a valid COMMERCIAL_FISHERY_EXEMPTION in British Columbia.

: This customer is exempt from specific taxes for holding a valid COMMERCIAL_FISHERY_EXEMPTION in British Columbia. CA_MB_COMMERCIAL_FISHERY_EXEMPTION : This customer is exempt from specific taxes for holding a valid COMMERCIAL_FISHERY_EXEMPTION in Manitoba.

: This customer is exempt from specific taxes for holding a valid COMMERCIAL_FISHERY_EXEMPTION in Manitoba. CA_NS_COMMERCIAL_FISHERY_EXEMPTION : This customer is exempt from specific taxes for holding a valid COMMERCIAL_FISHERY_EXEMPTION in Nova Scotia.

: This customer is exempt from specific taxes for holding a valid COMMERCIAL_FISHERY_EXEMPTION in Nova Scotia. CA_PE_COMMERCIAL_FISHERY_EXEMPTION : This customer is exempt from specific taxes for holding a valid COMMERCIAL_FISHERY_EXEMPTION in Prince Edward Island.

: This customer is exempt from specific taxes for holding a valid COMMERCIAL_FISHERY_EXEMPTION in Prince Edward Island. CA_SK_COMMERCIAL_FISHERY_EXEMPTION : This customer is exempt from specific taxes for holding a valid COMMERCIAL_FISHERY_EXEMPTION in Saskatchewan.

: This customer is exempt from specific taxes for holding a valid COMMERCIAL_FISHERY_EXEMPTION in Saskatchewan. CA_BC_PRODUCTION_AND_MACHINERY_EXEMPTION : This customer is exempt from specific taxes for holding a valid PRODUCTION_AND_MACHINERY_EXEMPTION in British Columbia.

: This customer is exempt from specific taxes for holding a valid PRODUCTION_AND_MACHINERY_EXEMPTION in British Columbia. CA_SK_PRODUCTION_AND_MACHINERY_EXEMPTION : This customer is exempt from specific taxes for holding a valid PRODUCTION_AND_MACHINERY_EXEMPTION in Saskatchewan.

: This customer is exempt from specific taxes for holding a valid PRODUCTION_AND_MACHINERY_EXEMPTION in Saskatchewan. CA_BC_SUB_CONTRACTOR_EXEMPTION : This customer is exempt from specific taxes for holding a valid SUB_CONTRACTOR_EXEMPTION in British Columbia.

: This customer is exempt from specific taxes for holding a valid SUB_CONTRACTOR_EXEMPTION in British Columbia. CA_SK_SUB_CONTRACTOR_EXEMPTION : This customer is exempt from specific taxes for holding a valid SUB_CONTRACTOR_EXEMPTION in Saskatchewan.

: This customer is exempt from specific taxes for holding a valid SUB_CONTRACTOR_EXEMPTION in Saskatchewan. CA_BC_CONTRACTOR_EXEMPTION : This customer is exempt from specific taxes for holding a valid CONTRACTOR_EXEMPTION in British Columbia.

: This customer is exempt from specific taxes for holding a valid CONTRACTOR_EXEMPTION in British Columbia. CA_SK_CONTRACTOR_EXEMPTION : This customer is exempt from specific taxes for holding a valid CONTRACTOR_EXEMPTION in Saskatchewan.

: This customer is exempt from specific taxes for holding a valid CONTRACTOR_EXEMPTION in Saskatchewan. CA_ON_PURCHASE_EXEMPTION : This customer is exempt from specific taxes for holding a valid PURCHASE_EXEMPTION in Ontario.

: This customer is exempt from specific taxes for holding a valid PURCHASE_EXEMPTION in Ontario. CA_MB_FARMER_EXEMPTION : This customer is exempt from specific taxes for holding a valid FARMER_EXEMPTION in Manitoba.

: This customer is exempt from specific taxes for holding a valid FARMER_EXEMPTION in Manitoba. CA_NS_FARMER_EXEMPTION : This customer is exempt from specific taxes for holding a valid FARMER_EXEMPTION in Nova Scotia.

: This customer is exempt from specific taxes for holding a valid FARMER_EXEMPTION in Nova Scotia. CA_SK_FARMER_EXEMPTION: This customer is exempt from specific taxes for holding a valid FARMER_EXEMPTION in Saskatchewan.

tax_lines "tax_lines" : [ { "price" : 11.94 , "rate" : 0.06 , "title" : "State Tax" } ] An array of tax line objects, each of which details a tax applicable to the order. Each object has the following properties: price : The amount of tax to be charged.

: The amount of tax to be charged. rate : The rate of tax to be applied.

: The rate of tax to be applied. title: The name of the tax.

applied_discount "applied_discount" : { "title" : "Title of the discount" , "description" : "Description" , "value" : "10" , "value_type" : "fixed_amount" , "amount" : "10" } The discount applied to the line item or the draft order object. Each draft order object can have one applied_discount object and each draft order line item can have its own applied_discount . The object has the following properties: title : Title of the discount.

: Title of the discount. description : Reason for the discount.

: 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.

: The value of the discount. If the type of discount is , then it corresponds to a fixed dollar amount. If the type is , then it corresponds to percentage. value_type : The type of discount. Valid values: percentage , fixed_amount .

: The type of discount. Valid values: , . amount: The applied amount of the discount, based on the setting of value_type . For more information, see Applying discounts.

taxes_included "taxes_included" : false Whether taxes are included in the order subtotal. Valid values are true or false .

total_tax "total_tax" : "11.94" The sum of all the taxes applied to the order.

subtotal_price "subtotal_price" : 398.0 the price of the order before shipping and taxes.

total_price "total_price" : "409.94" The sum of all the prices of all the items in the order, taxes and discounts included.

completed_at "completed_at" : "2012-08-24T14:02:15-04:00" The date and time (ISO 8601 format) when the order is created and the draft order is completed.

created_at "created_at" : "2008-01-10T11:00:00-05:00" The date and time (ISO 8601 format) when the order was created in Shopify.