Order

An order is a customer's completed request to purchase one or more products from a shop. An order is created when a customer completes the checkout process, during which time they provide an email address or phone number, billing address and payment information.

Orders can be created through the API, but no payment information will be collected, and no transaction performed. You can mark the order with any payment status.

You can also allow merchants to create orders manually by using the DraftOrder resource.

Caution

You can't use the Order API to create a new checkout for an individual store. To do so, you need to use an SDK that's powered by the Storefront API instead, such as the JavaScript Buy, iOS Buy, and Android Buy SDKs.

Caution

As of June 6th, 2018, only the last 60 days' worth of orders from a store will be accessible from the Order resource by default. If you want to access older orders, then you need to request access to all orders. If your app is granted access, then you can add the read_all_orders scope to your app along with read_orders or write_orders.

After an order is created, you can change only a few of its attributes using the API. You cannot change the items or the quantities in an order.

What you can do with Order

The Shopify API lets you do the following with the Order resource. More detailed versions of these general actions may be available:

Order properties

app_id
"app_id": 1966818

The ID of the app that created the order.

billing_address
"billing_address": {
  "address1": "2259 Park Ct",
  "address2": "",
  "city": "Drayton Valley",
  "company": null,
  "country": "Canada",
  "first_name": "Christopher",
  "id": 207119551,
  "last_name": "Gorski",
  "phone": "(555)555-5555",
  "province": "Alberta",
  "zip": "T0E 0M0",
  "name": "Christopher Gorski",
  "province_code": "AB",
  "country_code": "CA"
}

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.
  • address2: An optional additional field for the street address of the billing address.
  • city: The city, town, or village 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 format) 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 region (province, state, prefecture, …) of the billing address.
  • province_code: The two-letter abbreviation of the region of the billing address.
  • zip: The postal code (zip, postcode, Eircode, …) of the billing address.
browser_ip
"browser_ip": "216.191.105.146"

The IP address of the browser used by the customer when they placed the order.

buyer_accepts_marketing
"buyer_accepts_marketing": false

Whether the customer consented to receive email updates from the shop.

cancel_reason
"cancel_reason": "customer"

The reason why the order was canceled. Valid values:

  • customer: The customer canceled the order.
  • fraud: The order was fraudulent.
  • inventory: Items in the order were not in inventory.
  • declined: The payment was declined.
  • other: A reason not in this list.
cancelled_at
"cancelled_at": null

The date and time ( ISO 8601 format) when the order was canceled.

cart_token
"cart_token": "68778783ad298f1c80c3bafcddeea"

The ID for the cart that's associated with the order.

client_details
"client_details": {
  "accept_language": "en-US,en;q=0.9",
  "browser_height": 1320,
  "browser_ip": "216.191.105.146",
  "browser_width": 1280,
  "session_hash": "9ad4d1f4e6a8977b9dd98eed1e477643",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.94 Safari/537.36"
}

Information about the browser that the customer used when they placed their order:

  • accept_language: The languages and locales that the browser understands.
  • browser_height: The browser screen height in pixels, if available.
  • browser_ip: The browser IP address.
  • browser_width: The browser screen width in pixels, if available.
  • session_hash: A hash of the session.
  • user_agent: Details of the browsing client, including software and operating versions.
closed_at
"closed_at": "2008-01-10T11:00:00-05:00"

The date and time (ISO 8601 format) when the order was closed.

created_at
"created_at": "2008-01-10T11:00:00-05:00"

The autogenerated date and time (ISO 8601 format) when the order was created in Shopify. The value for this property cannot be changed.

currency
"currency": "USD"

The three-letter code (ISO 4217 format) for the currency used for the payment.

customer
"customer": {
  "accepts_marketing": false,
  "created_at": "2012-03-13T16:09:55-04:00",
  "email": "bob.norman@hostmail.com",
  "phone": "+13125551212",
  "first_name": "Bob",
  "id": 207119551,
  "last_name": "Norman",
  "note": null,
  "orders_count": "0",
  "state": null,
  "total_spent": "0.00",
  "updated_at": "2012-03-13T16:09:55-04:00",
  "tags": "loyal"
}

Information about the customer. The order might not have a customer and apps should not depend on the existence of a customer object. This value might be null if the order was created through Shopify POS. For more information about the customer object, see the Customer resource.

customer_locale
"customer_locale": "en-CA"

The two or three-letter language code, optionally followed by a region modifier.

discount_applications
"discount_applications": [
  {
    "type": "manual",
    "title": "custom discount",
    "description": "customer deserved it",
    "value": "2.0",
    "value_type": "fixed_amount",
    "allocation_method": "one",
    "target_selection": "explicit",
    "target_type": "line_item"
  },
  {
    "type": "script",
    "description": "my scripted discount",
    "value": "5.0",
    "value_type": "fixed_amount",
    "allocation_method": "one",
    "target_selection": "explicit",
    "target_type": "shipping_line"
  },
  {
    "type": "discount_code",
    "code": "SUMMERSALE",
    "value": "10.0",
    "value_type": "fixed_amount",
    "allocation_method": "across",
    "target_selection": "all",
    "target_type": "line_item"
  }
]

An ordered list of stacked discount applications.

The discount_applications property includes 3 types: discount_code, manual, and script. All 3 types share a common structure and have some type specific attributes.

  • allocation_method: The method by which the discount application value has been allocated to entitled lines. Valid values:
    • across: The value is spread across all entitled lines.
    • each: The value is applied onto every entitled line.
    • one: The value is applied onto a single line.
  • code: The discount code that was used to apply the discount. Available only for discount code applications.
  • description: The description of the discount application, as defined by the merchant or the Shopify Script. Available only for manual and script discount applications.
  • target_selection: The lines on the order, of the type defined by target_type, that the discount is allocated over. Valid values:
    • all: The discount is allocated onto all lines,
    • entitled: The discount is allocated only onto lines it is entitled for.
    • explicit: The discount is allocated onto explicitly selected lines.
  • target_type: The type of line on the order that the discount is applicable on. Valid values:
    • line_item: The discount applies to line items.
    • shipping_line: The discount applies to shipping lines.
  • title: The title of the discount application, as defined by the merchant. Available only for manual discount applications.
  • type: The discount application type. Valid values:
    • manual: The discount was manually applied by the merchant (for example, by using an app or creating a draft order).
    • script: The discount was applied by a Shopify Script.
    • discount_code: The discount was applied by a discount code.
  • value: The value of the discount application as a decimal. This represents the intention of the discount application. For example, if the intent was to apply a 20% discount, then the value will be 20.0. If the intent was to apply a $15 discount, then the value will be 15.0.
  • value_type: The type of the value. Valid values:
    • fixed_amount: A fixed amount discount value in the currency of the order.
    • percentage: A percentage discount value.
discount_codes
"discount_codes": [
  {
    "code": "SPRING30",
    "amount": "30.00",
    "type": "fixed_amount"
  }
]

A list of discount codes applied to the order. Each discount code object includes the following fields:

  • amount: The value of the discount to be deducted from the order total. The type field determines how this value is calculated. After an order is created, this field returns the calculated amount.
  • code: The discount code.
  • type: The type of discount. Default value: fixed_amount. Valid values:
    • fixed_amount: Applies amount as a unit of the store's currency. For example, if amount is 30 and the store's currency is USD, then 30 USD is deducted from the order total when the discount is applied.
    • percentage: Applies a discount of amount as a percentage of the order total.
    • shipping: Applies a free shipping discount on orders that have a shipping rate less than or equal to amount. For example, if amount is 30, then the discount will give the customer free shipping for any shipping rate that is less than or equal to $30.
email
"email": "bob.norman@hostmail.com"

The customer's email address.

financial_status
"financial_status": "authorized"

The status of payments associated with the order. Valid values:

  • pending: The payments are pending. Payment might fail in this state. Check again to confirm whether the payments have been paid successfully.
  • authorized: The payments have been authorized.
  • partially_paid: The order have been partially paid.
  • paid: The payments have been paid.
  • partially_refunded: The payments have been partially refunded.
  • refunded: The payments have been refunded.
  • voided: The payments have been voided.
fulfillments
"fulfillments": [
  {
    "created_at": "2012-03-13T16:09:54-04:00",
    "id": 255858046,
    "order_id": 450789469,
    "status": "failure",
    "tracking_company": null,
    "tracking_number": "1Z2345",
    "updated_at": "2012-05-01T14:22:25-04:00"
  }
]

A list of fulfillments associated with the order. For more information, see the Fulfillment API.

fulfillment_status
"fulfillment_status": "partial"

The order's status in terms of fulfilled line items. Valid values:

  • fulfilled: Every line item in the order has been fulfilled.
  • null: None of the line items in the order have been fulfilled.
  • partial: At least one line item in the order has been fulfilled.
  • restocked: Every line item in the order has been restocked and the order canceled.
gateway
deprecated
"gateway": "shopify_payments"

The payment gateway used.

Use the Transaction resource instead.

id
"id": 450789469

The ID of the order, used for API purposes. This is different from the order_number property, which is a unique identifier for the order that's used by the shop owner and customer.

landing_site
"landing_site": "http://www.example.com?source=abc"

The URL for the page where the buyer landed when they entered the shop.

line_items
"line_items": [
  {
    "fulfillable_quantity": 1,
    "fulfillment_service": "amazon",
    "fulfillment_status": "fulfilled",
    "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": "State Tax",
        "price": "3.98",
        "rate": 0.06
      }
    ],
    "total_discount": "5.00",
    "discount_allocations": [
      {
        "amount": "5.00",
        "discount_application_index": 2
      }
    ]
  }
]

A list of line item objects, each containing information about an item in the order. Each object has the following properties:

  • fulfillable_quantity: The amount available to fulfill, calculated as follows:
    quantity - max(refunded_quantity, fulfilled_quantity) - pending_fulfilled_quantity - open_fulfilled_quantity
  • fulfillment_service: The service provider that's fulfilling the item. Valid values: manual, or the name of the provider, such as amazon or shipwire.
  • fulfillment_status: How far along an order is in terms line items fulfilled. Valid values: null, fulfilled, partial, and not_eligible.
  • grams: The weight of the item in grams.
  • id: The ID for the line item.
  • price: The price of the item before discounts have been applied.
  • product_id: The ID for the product that the line item belongs to. Can be null if the original product associated with the order is deleted at a later date.
  • quantity: The number of items that were purchased.
  • requires_shipping: Whether the item requires shipping.
  • sku: The item's SKU (stock keeping unit).
  • title: The title of the product.
  • variant_id: The ID of the product variant.
  • variant_title: The title of the product variant.
  • vendor: The name of the item's supplier.
  • name: The name of the product variant.
  • gift_card: Whether the item is a gift card. If true, then the item is not taxed or considered for shipping charges.
  • properties: An array of custom information for the item that has been added to the cart. Often used to provide product customization options. For more information, see Get customization information for products with line item properties.
  • taxable: Whether the item was taxable.
  • tax_lines: A list of tax line objects, each of which details a tax applied to the item.
  • tip_payment_gateway: The payment gateway used to tender the tip, such as shopify_payments. Present only on tips.
  • tip_payment_method: The payment method used to tender the tip, such as Visa. Present only on tips.
  • total_discount: The total discount amount applied to this line item. This value is not subtracted in the line item price.
  • discount_allocations: An ordered list of amounts allocated by discount applications. Each discount allocation is associated to a particular discount application.
    • amount: The discount amount allocated to the line.
    • discount_application_index: The index of the associated discount application in the order's discount_applications list.
location_id
"location_id": 49202758

The ID for the physical location where the order was processed.

name
"name": "#1001"

The order name as represented by a number.

note
"note": "Customer changed their mind."

An optional note that a shop owner can attach to the 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.

number
"number": 1000

For internal use only. An identifier unique to the shop. Numbers are sequential and start at 1000.

order_number
"order_number": 1001

A unique identifier for the order, used by the shop owner and customer. This is different from the id property, which is the unique identifier used for API purposes.

payment_details
deprecated
"payment_details": {
  "avs_result_code": "Y",
  "credit_card_bin": "453600",
  "cvv_result_code": "M",
  "credit_card_number": "•••• •••• •••• 4242",
  "credit_card_company": "Visa"
}

An object containing information about the payment. It has the following properties:

  • avs_result_code: The response code from the address verification system (AVS). The code is a single letter. See this chart for the codes and their definitions.
  • credit_card_bin: The issuer identification number (IIN), formerly known as the bank identification number (BIN), of the customer's credit card. This is made up of the first few digits of the credit card number.
  • credit_card_company: The name of the company who issued the customer's credit card.
  • credit_card_number: The customer's credit card number, with most of the leading digits redacted.
  • cvv_result_code: The response code from the credit card company indicating whether the customer entered the card security code (card verification value) correctly. The code is a single letter or empty string. See this chart for the codes and their definitions.

Use the Transaction resource instead.

payment_gateway_names
"payment_gateway_names": [
  "authorize_net",
  "Cash on Delivery (COD)"
]

The list of payment gateways used for the order.

phone
"phone": "+557734881234"

The customer's phone number.

processed_at
"processed_at": "2008-01-10T11:00:00-05:00"

The date and time (ISO 8601 format) when an order was processed. This value is the date that appears on your orders and that's used in the analytic reports. By default, it matches the created_at value. If you're importing orders from an app or another platform, then you can set processed_at to a date and time in the past to match when the original order was created.

processing_method
"processing_method": "direct"

How the payment was processed. Valid values: checkout, direct, manual, offsite, and express.

referring_site
"referring_site": "http://www.anexample.com"

The website where the customer clicked a link to the shop.

refunds
"refunds": [
  {
    "id": 18423447608,
    "order_id": 394481795128,
    "created_at": "2018-03-06T09:35:37-05:00",
    "note": null,
    "user_id": null,
    "processed_at": "2018-03-06T09:35:37-05:00",
    "restock": false,
    "refund_line_items": [],
    "transactions": [],
    "order_adjustments": []
  }
]

A list of refunds applied to the order. For more information, see the Refund API.

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.
  • address2: An optional additional field for the street address of the shipping address.
  • city: The city, town, or village 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 (ISO 3166-1 format) for the country of the shipping address.
  • first_name: The first name of the person associated with the shipping address.
  • last_name: The last name of the person associated with the shipping address.
  • 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 region (province, state, prefecture, …) of the shipping address.
  • province_code: The two-letter abbreviation of the region of the shipping address.
  • zip: The postal code (zip, postcode, Eircode, …) of the shipping address.
shipping_lines
"shipping_lines": [
  {
    "code": "Free Shipping",
    "price": "0.00",
    "source": "shopify",
    "title": "Free Shipping",
    "tax_lines": [
      {
        "title": "State Tax",
        "price": "3.98",
        "rate": 0.06
      }
    ],
    "carrier_identifier": "third_party_carrier_identifier",
    "requested_fulfillment_service_id": "third_party_fulfillment_service_id"
  }
]

An array of objects, each of which details a shipping method used. Each object has the following properties:

  • code: A reference to the shipping method.
  • price: The price of this shipping method.
  • source: The source of the shipping method.
  • title: The title of the shipping method.
  • tax_lines: A list of tax line objects, each of which details a tax applicable to this shipping line.
  • carrier_identifier: A reference to the carrier service that provided the rate. Present when the rate was computed by a third-party carrier service.
  • requested_fulfillment_service_id: A reference to the fulfillment service that is being requested for the shipping method. Present if the shipping method requires processing by a third party fulfillment service; null otherwise.
source_name
"source_name": "web"

Where the order originated. Can be set only during order creation, and is not writeable afterwards. Values for Shopify channels are protected and cannot be assigned by other API clients: web, pos, iphone, and android. Orders created via the API can be assigned any other string of your choice. If unspecified, then new orders are assigned the value api.

subtotal_price
"subtotal_price": 398.0

The price of the order after discounts but before shipping, taxes and tips.

tags
"tags": "imported"

Tags attached to the order, formatted as a string of comma-separated values. Tags are additional short descriptors, commonly used for filtering and searching. Each individual tag is limited to 40 characters in length.

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.
  • rate: The rate of tax to be applied.
  • title: The name of the tax.
When creating an order through the API, tax lines can be specified on the order or the line items but not both. Tax lines specified on the order are split across the taxable line items in the created order.
taxes_included
"taxes_included": false

Whether taxes are included in the order subtotal.

token
"token": "b1946ac92492d2347c6235b4d2611184"

A unique identifier for the order.

total_discounts
"total_discounts": "0.00"

The total amount of the discounts applied to the price of the order.

total_line_items_price
"total_line_items_price": "398.00"

The sum of all line item prices.

total_price
"total_price": "409.94"

The sum of all line item prices, discounts, shipping, taxes, and tips (must be positive).

total_tax
"total_tax": "11.94"

The sum of all the taxes applied to the order (must be positive).

total_tip_received
"total_tip_received": "4.87"

The sum of all the tips in the order.

total_weight
"total_weight": 300

The sum of all line item weights in grams.

updated_at
"updated_at": "2012-08-24T14:02:15-04:00"

The date and time (ISO 8601 format) when the order was last modified.

Filtering orders by updated_at is not an effective method for fetching orders because its value can change when no visible fields of an order have been updated. Use the Webhook and Event APIs to subscribe to order events instead.

user_id
"user_id": 31522279

The ID of the user logged into the Shopify POS that processed the order, if applicable.

order_status_url
"order_status_url": "https://checkout.shopify.com/112233/checkouts/4207896aad57dfb159/thank_you_token?key=753621327b9e8a64789651bf221dfe35"

The URL pointing to the order status web page, if applicable.

Endpoints

GET /admin/orders.json
Retrieves a list of orders
ids

Retrieve certain orders, specified by a comma-separated list of order IDs.

limit

The maximum number of results to show on a page.

(default: 50, maximum: 250)
page

The page of results to show

(default: 1)
since_id

Show orders after the specified ID.

created_at_min

Show orders created at or after date (format: 2014-04-25T16:15:47-04:00).

created_at_max

Show orders created at or before date (format: 2014-04-25T16:15:47-04:00).

updated_at_min

Show orders last updated at or after date (format: 2014-04-25T16:15:47-04:00).

updated_at_max

Show orders last updated at or before date (format: 2014-04-25T16:15:47-04:00).

processed_at_min

Show orders imported at or after date (format: 2014-04-25T16:15:47-04:00).

processed_at_max

Show orders imported at or before date (format: 2014-04-25T16:15:47-04:00).

attribution_app_id

Show orders attributed to a certain app, specified by the app ID. Set as current to show orders for the app currently consuming the API.

status

Filter orders by their status.

(default: open)
  • open: Show only open orders.
  • closed: Show only closed orders.
  • cancelled: Show only canceled orders.
  • any: Show orders of any status.
financial_status

Filter orders by their financial status.

(default: any)
  • authorized: Show only authorized orders
  • pending: Show only pending orders
  • paid: Show only paid orders
  • partially_paid: Show only partially paid orders
  • refunded: Show only refunded orders
  • voided: Show only voided orders
  • partially_refunded: Show only partially refunded orders
  • any: Show orders of any financial status.
  • unpaid: Show authorized and partially paid orders.
fulfillment_status

Filter orders by their fulfillment status.

(default: any)
  • shipped: Show orders that have been shipped.
  • partial: Show partially shipped orders.
  • unshipped: Show orders that have not yet been shipped
  • any: Show orders of any fulfillment status.
fields

Retrieve only certain fields, specified by a comma-separated list of fields names.

Retrieve all orders

GET /admin/orders.json
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "409.94",
      "subtotal_price": "398.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "authorized",
      "confirmed": false,
      "total_discounts": "0.00",
      "total_line_items_price": "398.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "409.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": null,
      "landing_site_ref": null,
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax"
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://checkout.local/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=78e1675d9ac6ba6ed076b29dff5aaaea",
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "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"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "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"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2018-07-11T14:37:16-04:00",
          "service": "manual",
          "updated_at": "2018-07-11T14:37:16-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
          "tracking_urls": [
            "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "price": "199.00",
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "total_discount": "0.00",
              "fulfillment_status": null,
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2018-07-11T14:37:16-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2018-07-11T14:37:16-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 195.67,
              "total_tax": 3.98,
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "price": "199.00",
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "total_discount": "0.00",
                "fulfillment_status": null,
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 195.66,
              "total_tax": 3.98,
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "price": "199.00",
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "total_discount": "0.00",
                "fulfillment_status": null,
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "amount": "209.00",
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "currency": "USD",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2018-07-11T14:37:16-04:00",
        "updated_at": "2018-07-11T14:37:16-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "41.94",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "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
        }
      }
    }
  ]
}

Retrieve specific orders

GET /admin/orders.json?ids=1073459965
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 1073459965,
      "email": "",
      "closed_at": null,
      "created_at": "2018-07-11T14:44:20-04:00",
      "updated_at": "2018-07-11T14:44:20-04:00",
      "number": 2,
      "note": null,
      "token": "a860da3a3d5f840f650d3ca339863864",
      "gateway": "",
      "test": false,
      "total_price": "199.00",
      "subtotal_price": "199.00",
      "total_weight": null,
      "total_tax": "0.00",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "paid",
      "confirmed": true,
      "total_discounts": "0.00",
      "total_line_items_price": "199.00",
      "cart_token": null,
      "buyer_accepts_marketing": false,
      "name": "#1002",
      "referring_site": null,
      "landing_site": null,
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "199.00",
      "checkout_token": null,
      "reference": null,
      "user_id": null,
      "location_id": null,
      "source_identifier": null,
      "source_url": null,
      "processed_at": "2018-07-11T14:44:20-04:00",
      "device_id": null,
      "phone": null,
      "customer_locale": null,
      "app_id": 755357713,
      "browser_ip": null,
      "landing_site_ref": null,
      "order_number": 1002,
      "discount_applications": [],
      "discount_codes": [],
      "note_attributes": [],
      "payment_gateway_names": [],
      "processing_method": "",
      "checkout_id": null,
      "source_name": "755357713",
      "fulfillment_status": null,
      "tax_lines": [],
      "tags": "",
      "contact_email": null,
      "order_status_url": "https://checkout.local/690933842/orders/a860da3a3d5f840f650d3ca339863864/authenticate?key=3bfedd5ed2ae6b5d262d33c021e185a8",
      "admin_graphql_api_id": "gid://shopify/Order/1073459965",
      "line_items": [
        {
          "id": 1071823173,
          "variant_id": 447654529,
          "title": "IPod Touch 8GB",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2009BLACK",
          "variant_title": "Black",
          "vendor": "Apple",
          "fulfillment_service": "manual",
          "product_id": 921728736,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Touch 8GB - Black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 567,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/1071823173",
          "tax_lines": []
        }
      ],
      "shipping_lines": [],
      "fulfillments": [],
      "refunds": []
    }
  ]
}

Retrieve orders that have authorized payments ready to be captured

GET /admin/orders.json?financial_status=authorized
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "409.94",
      "subtotal_price": "398.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "authorized",
      "confirmed": false,
      "total_discounts": "0.00",
      "total_line_items_price": "398.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "409.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": null,
      "landing_site_ref": null,
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax"
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://checkout.local/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=b702185e1eb77751a04257123388b870",
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "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"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "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"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2018-07-11T14:37:16-04:00",
          "service": "manual",
          "updated_at": "2018-07-11T14:37:16-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
          "tracking_urls": [
            "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "price": "199.00",
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "total_discount": "0.00",
              "fulfillment_status": null,
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2018-07-11T14:37:16-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2018-07-11T14:37:16-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 195.67,
              "total_tax": 3.98,
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "price": "199.00",
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "total_discount": "0.00",
                "fulfillment_status": null,
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 195.66,
              "total_tax": 3.98,
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "price": "199.00",
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "total_discount": "0.00",
                "fulfillment_status": null,
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "amount": "209.00",
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "currency": "USD",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2018-07-11T14:37:16-04:00",
        "updated_at": "2018-07-11T14:37:16-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "41.94",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "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
        }
      }
    }
  ]
}

Retrieve orders last updated after 2005-07-31 15:57:11 in the EDT timezone

GET /admin/orders.json?updated_at_min=2005-07-31T15:57:11-04:00
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "409.94",
      "subtotal_price": "398.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "authorized",
      "confirmed": false,
      "total_discounts": "0.00",
      "total_line_items_price": "398.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "409.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": null,
      "landing_site_ref": null,
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax"
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://checkout.local/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=ef6cb2b0c73cfd3e290bac3c9fa93772",
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "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"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "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"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2018-07-11T14:37:16-04:00",
          "service": "manual",
          "updated_at": "2018-07-11T14:37:16-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
          "tracking_urls": [
            "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "price": "199.00",
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "total_discount": "0.00",
              "fulfillment_status": null,
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2018-07-11T14:37:16-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2018-07-11T14:37:16-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 195.67,
              "total_tax": 3.98,
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "price": "199.00",
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "total_discount": "0.00",
                "fulfillment_status": null,
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 195.66,
              "total_tax": 3.98,
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "price": "199.00",
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "total_discount": "0.00",
                "fulfillment_status": null,
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "amount": "209.00",
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "currency": "USD",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2018-07-11T14:37:16-04:00",
        "updated_at": "2018-07-11T14:37:16-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "41.94",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "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
        }
      }
    }
  ]
}

Retrieve all orders but show only certain properties

GET /admin/orders.json?fields=created_at,id,name,total-price
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "created_at": "2008-01-10T11:00:00-05:00",
      "total_price": "409.94",
      "name": "#1001"
    }
  ]
}

Retrieve all orders after the specified ID

GET /admin/orders.json?since_id=123
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "409.94",
      "subtotal_price": "398.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "authorized",
      "confirmed": false,
      "total_discounts": "0.00",
      "total_line_items_price": "398.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "409.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": null,
      "landing_site_ref": null,
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax"
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://checkout.local/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=93df5301cdc57cc91db2425056a5cc6e",
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "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"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "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"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2018-07-11T14:37:16-04:00",
          "service": "manual",
          "updated_at": "2018-07-11T14:37:16-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
          "tracking_urls": [
            "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "price": "199.00",
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "total_discount": "0.00",
              "fulfillment_status": null,
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2018-07-11T14:37:16-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2018-07-11T14:37:16-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 195.67,
              "total_tax": 3.98,
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "price": "199.00",
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "total_discount": "0.00",
                "fulfillment_status": null,
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 195.66,
              "total_tax": 3.98,
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "price": "199.00",
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "total_discount": "0.00",
                "fulfillment_status": null,
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "amount": "209.00",
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "currency": "USD",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2018-07-11T14:37:16-04:00",
        "updated_at": "2018-07-11T14:37:16-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "41.94",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "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
        }
      }
    }
  ]
}
GET /admin/orders/450789469.json
Retrieves a specific order
fields

Retrieve only certain fields, specified by a comma-separated list of fields names.

Retrieve a single order

GET /admin/orders/#{order_id}.json
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2008-01-10T11:00:00-05:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "409.94",
    "subtotal_price": "398.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "authorized",
    "confirmed": false,
    "total_discounts": "0.00",
    "total_line_items_price": "398.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "409.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": null,
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax"
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://checkout.local/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=42b4974d87db09a59fafd134462a66f3",
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "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"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "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"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2018-07-11T14:37:16-04:00",
        "service": "manual",
        "updated_at": "2018-07-11T14:37:16-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
        "tracking_urls": [
          "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "price": "199.00",
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "total_discount": "0.00",
            "fulfillment_status": null,
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2018-07-11T14:37:16-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2018-07-11T14:37:16-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 195.67,
            "total_tax": 3.98,
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "price": "199.00",
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "total_discount": "0.00",
              "fulfillment_status": null,
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 195.66,
            "total_tax": 3.98,
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "price": "199.00",
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "total_discount": "0.00",
              "fulfillment_status": null,
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "amount": "209.00",
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "currency": "USD",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2018-07-11T14:37:16-04:00",
      "updated_at": "2018-07-11T14:37:16-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "41.94",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "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
      }
    }
  }
}

Get only particular fields

GET /admin/orders/#{order_id}.json?fields=id,line_items,name,total_price
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "total_price": "409.94",
    "name": "#1001",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ]
  }
}
GET /admin/orders/count.json
Retrieves an order count
created_at_min

Count orders created after date (format: 2014-04-25T16:15:47-04:00).

created_at_max

Count orders created before date (format: 2014-04-25T16:15:47-04:00).

updated_at_min

Count orders last updated after date (format: 2014-04-25T16:15:47-04:00).

updated_at_max

Count orders last updated before date (format: 2014-04-25T16:15:47-04:00).

status

Count orders of a given status.

(default: open)
  • open: Count open orders.
  • closed: Count closed orders.
  • any: Count orders of any status.
financial_status

Count orders of a given financial status.

(default: any)
  • authorized: Count authorized orders.
  • pending: Count pending orders.
  • paid: Count paid orders.
  • refunded: Count refunded orders.
  • voided: Count voided orders.
  • any: Count orders of any financial status.
fulfillment_status

Count orders of a given fulfillment status.

(default: any)
  • shipped: Count orders that have been shipped.
  • partial: Count partially shipped orders.
  • unshipped: Count orders that have not yet been shipped.
  • any: Count orders of any fulfillment status.

Count all orders

GET /admin/orders/count.json
View Response
HTTP/1.1 200 OK
{
  "count": 1
}

Count orders that have authorized payments ready to be captured

GET /admin/orders/count.json?financial_status=authorized
View Response
HTTP/1.1 200 OK
{
  "count": 1
}
POST /admin/orders/450789469/close.json
Closes an order

Close an order

POST /admin/orders/#{order_id}/close.json
{
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": "2018-07-11T14:44:27-04:00",
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2018-07-11T14:44:27-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "409.94",
    "subtotal_price": "398.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "authorized",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "398.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "409.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax"
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://checkout.local/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=9ec50ba76379e2c5cb14f7ad5f775ff7",
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "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"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "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"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2018-07-11T14:37:16-04:00",
        "service": "manual",
        "updated_at": "2018-07-11T14:37:16-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
        "tracking_urls": [
          "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "price": "199.00",
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "total_discount": "0.00",
            "fulfillment_status": null,
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2018-07-11T14:37:16-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2018-07-11T14:37:16-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 195.67,
            "total_tax": 3.98,
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "price": "199.00",
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "total_discount": "0.00",
              "fulfillment_status": null,
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 195.66,
            "total_tax": 3.98,
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "price": "199.00",
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "total_discount": "0.00",
              "fulfillment_status": null,
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "amount": "209.00",
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "currency": "USD",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2018-07-11T14:37:16-04:00",
      "updated_at": "2018-07-11T14:37:16-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "41.94",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "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
      }
    }
  }
}
POST /admin/orders/450789469/open.json
Re-opens a closed order

Re-open a closed order

POST /admin/orders/#{order_id}/open.json
{
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2018-07-11T14:44:30-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "409.94",
    "subtotal_price": "398.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "authorized",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "398.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "409.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax"
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://checkout.local/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=6c05c696d480fbf6a08ff3215c546efb",
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "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"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "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"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2018-07-11T14:37:16-04:00",
        "service": "manual",
        "updated_at": "2018-07-11T14:37:16-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
        "tracking_urls": [
          "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "price": "199.00",
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "total_discount": "0.00",
            "fulfillment_status": null,
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2018-07-11T14:37:16-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2018-07-11T14:37:16-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 195.67,
            "total_tax": 3.98,
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "price": "199.00",
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "total_discount": "0.00",
              "fulfillment_status": null,
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 195.66,
            "total_tax": 3.98,
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "price": "199.00",
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "total_discount": "0.00",
              "fulfillment_status": null,
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "amount": "209.00",
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "currency": "USD",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2018-07-11T14:37:16-04:00",
      "updated_at": "2018-07-11T14:37:16-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "41.94",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "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
      }
    }
  }
}
POST /admin/orders/450789469/cancel.json
Cancels an order. Orders that have a fulfillment object can't be canceled.
amount

The amount to refund. If set, Shopify attempts to void or refund the payment, depending on its status.

restock

Whether to restock refunded items back to your store's inventory.

(default: false)
reason

The reason for the order cancellation. Valid values: customer, inventory, fraud, declined, and other.)

(default: other)
email

Whether to send an email to the customer notifying them of the cancellation.

(default: false)
refund

The refund transactions to perform. Required for some more complex refund situations. For more information, see the Refund API.

Cancel an order

POST /admin/orders/#{order_id}/cancel.json
{
}
View Response
HTTP/1.1 200 OK
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2008-01-10T11:00:00-05:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "authorize_net",
  "test": false,
  "total_price": "409.94",
  "subtotal_price": "398.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "authorized",
  "confirmed": false,
  "total_discounts": "0.00",
  "total_line_items_price": "398.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "409.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": null,
  "landing_site_ref": null,
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax"
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://checkout.local/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=dced6506ea277aa7592d3100101e71ad",
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "price": "199.00",
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "total_discount": "0.00",
      "fulfillment_status": null,
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "price": "199.00",
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "total_discount": "0.00",
      "fulfillment_status": null,
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "total_discount": "0.00",
      "fulfillment_status": null,
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "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"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "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"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2018-07-11T14:37:16-04:00",
      "service": "manual",
      "updated_at": "2018-07-11T14:37:16-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
      "tracking_urls": [
        "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 509562969,
      "order_id": 450789469,
      "created_at": "2018-07-11T14:37:16-04:00",
      "note": "it broke during shipping",
      "user_id": 799407056,
      "processed_at": "2018-07-11T14:37:16-04:00",
      "restock": true,
      "admin_graphql_api_id": "gid://shopify/Refund/509562969",
      "refund_line_items": [
        {
          "id": 104689539,
          "quantity": 1,
          "line_item_id": 703073504,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 195.67,
          "total_tax": 3.98,
          "line_item": {
            "id": 703073504,
            "variant_id": 457924702,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "price": "199.00",
            "sku": "IPOD2008BLACK",
            "variant_title": "black",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "total_discount": "0.00",
            "fulfillment_status": null,
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06
              }
            ]
          }
        },
        {
          "id": 709875399,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 195.66,
          "total_tax": 3.98,
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "price": "199.00",
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "total_discount": "0.00",
            "fulfillment_status": null,
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 179259969,
          "order_id": 450789469,
          "amount": "209.00",
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": null,
          "created_at": "2005-08-05T12:59:12-04:00",
          "test": false,
          "authorization": "authorization-key",
          "currency": "USD",
          "location_id": null,
          "user_id": null,
          "parent_id": 801038806,
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "web",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
        }
      ],
      "order_adjustments": []
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2018-07-11T14:37:16-04:00",
    "updated_at": "2018-07-11T14:37:16-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "41.94",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "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
    }
  }
},
  "notice": "Order has been canceled"
}

Cancel and refund an order using the amount property

POST /admin/orders/#{order_id}/cancel.json
{
  "note": "Broke in shipping",
  "amount": "10.00"
}
View Response
HTTP/1.1 200 OK
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2018-07-11T14:44:34-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "bogus",
  "test": true,
  "total_price": "409.94",
  "subtotal_price": "398.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "authorized",
  "confirmed": true,
  "total_discounts": "0.00",
  "total_line_items_price": "398.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "409.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": null,
  "landing_site_ref": null,
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax"
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://checkout.local/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=90ff24bc698af5267ddef68f5d4e03bf",
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "price": "199.00",
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 0,
      "grams": 200,
      "total_discount": "0.00",
      "fulfillment_status": null,
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "price": "199.00",
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 0,
      "grams": 200,
      "total_discount": "0.00",
      "fulfillment_status": null,
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 0,
      "grams": 200,
      "total_discount": "0.00",
      "fulfillment_status": null,
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "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"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "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"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2018-07-11T14:37:16-04:00",
      "service": "manual",
      "updated_at": "2018-07-11T14:37:16-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
      "tracking_urls": [
        "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 929361462,
      "order_id": 450789469,
      "created_at": "2018-07-11T14:44:34-04:00",
      "note": null,
      "user_id": null,
      "processed_at": "2018-07-11T14:44:34-04:00",
      "restock": false,
      "admin_graphql_api_id": "gid://shopify/Refund/929361462",
      "refund_line_items": [
        {
          "id": 1058498307,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 195.66,
          "total_tax": 3.98,
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "price": "199.00",
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 200,
            "total_discount": "0.00",
            "fulfillment_status": null,
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06
              }
            ]
          }
        },
        {
          "id": 1058498308,
          "quantity": 1,
          "line_item_id": 518995019,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 195.67,
          "total_tax": 3.98,
          "line_item": {
            "id": 518995019,
            "variant_id": 49148385,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "price": "199.00",
            "sku": "IPOD2008RED",
            "variant_title": "red",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - red",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 200,
            "total_discount": "0.00",
            "fulfillment_status": null,
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06
              }
            ]
          }
        },
        {
          "id": 1058498309,
          "quantity": 1,
          "line_item_id": 703073504,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 195.67,
          "total_tax": 3.98,
          "line_item": {
            "id": 703073504,
            "variant_id": 457924702,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "price": "199.00",
            "sku": "IPOD2008BLACK",
            "variant_title": "black",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 200,
            "total_discount": "0.00",
            "fulfillment_status": null,
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 1072844669,
          "order_id": 450789469,
          "amount": "10.00",
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": "Bogus Gateway: Forced success",
          "created_at": "2018-07-11T14:44:33-04:00",
          "test": true,
          "authorization": null,
          "currency": "USD",
          "location_id": null,
          "user_id": null,
          "parent_id": 1072844668,
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "755357713",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/1072844669"
        }
      ],
      "order_adjustments": []
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2018-07-11T14:37:16-04:00",
    "updated_at": "2018-07-11T14:37:16-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "41.94",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "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
    }
  }
},
  "notice": "Order has been canceled"
}

When an order has multiple refundable transactions, refunding an amount less than its net payment without a refund property fails with an error

POST /admin/orders/#{order_id}/cancel.json
{
  "note": "Broke in shipping",
  "amount": "109.00"
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2018-07-11T14:44:35-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "authorize_net",
  "test": false,
  "total_price": "409.94",
  "subtotal_price": "398.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "authorized",
  "confirmed": true,
  "total_discounts": "0.00",
  "total_line_items_price": "398.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "409.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": null,
  "landing_site_ref": null,
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus",
    "gift_card"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax"
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://checkout.local/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=411fa813577b5ac480f904da5b290a8c",
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "price": "199.00",
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "total_discount": "0.00",
      "fulfillment_status": null,
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "price": "199.00",
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "total_discount": "0.00",
      "fulfillment_status": null,
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "total_discount": "0.00",
      "fulfillment_status": null,
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "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"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "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"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2018-07-11T14:37:16-04:00",
      "service": "manual",
      "updated_at": "2018-07-11T14:37:16-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
      "tracking_urls": [
        "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2018-07-11T14:37:16-04:00",
    "updated_at": "2018-07-11T14:37:16-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "41.94",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "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
    }
  }
},
  "error": "Refund parameter required to process refund"
}

Cancel and refund an order using the refund property

POST /admin/orders/#{order_id}/cancel.json
{
  "refund": {
    "restock": true,
    "note": "Broke in shipping",
    "shipping": {
      "full_refund": true
    },
    "refund_line_items": [
      {
        "line_item_id": 466157049,
        "quantity": 1
      }
    ],
    "transactions": [
      {
        "parent_id": 1072844674,
        "amount": "10.00",
        "kind": "refund",
        "gateway": "bogus"
      },
      {
        "parent_id": 1072844675,
        "amount": "100.00",
        "kind": "refund",
        "gateway": "gift_card"
      }
    ]
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2018-07-11T14:44:39-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "gift_card",
  "test": true,
  "total_price": "409.94",
  "subtotal_price": "398.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "authorized",
  "confirmed": true,
  "total_discounts": "0.00",
  "total_line_items_price": "398.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "409.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": null,
  "landing_site_ref": null,
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus",
    "gift_card"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax"
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://checkout.local/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=5b21f96fa77781da994071da247bf519",
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "price": "199.00",
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 0,
      "grams": 200,
      "total_discount": "0.00",
      "fulfillment_status": null,
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "price": "199.00",
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "total_discount": "0.00",
      "fulfillment_status": null,
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "total_discount": "0.00",
      "fulfillment_status": null,
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "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"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "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"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2018-07-11T14:37:16-04:00",
      "service": "manual",
      "updated_at": "2018-07-11T14:37:16-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
      "tracking_urls": [
        "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": null,
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 929361463,
      "order_id": 450789469,
      "created_at": "2018-07-11T14:44:38-04:00",
      "note": "Broke in shipping",
      "user_id": null,
      "processed_at": "2018-07-11T14:44:38-04:00",
      "restock": true,
      "admin_graphql_api_id": "gid://shopify/Refund/929361463",
      "refund_line_items": [
        {
          "id": 1058498310,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 195.66,
          "total_tax": 3.98,
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "price": "199.00",
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 200,
            "total_discount": "0.00",
            "fulfillment_status": null,
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 1072844676,
          "order_id": 450789469,
          "amount": "10.00",
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": "Bogus Gateway: Forced success",
          "created_at": "2018-07-11T14:44:38-04:00",
          "test": true,
          "authorization": null,
          "currency": "USD",
          "location_id": null,
          "user_id": null,
          "parent_id": 1072844674,
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "755357713",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/1072844676"
        },
        {
          "id": 1072844677,
          "order_id": 450789469,
          "amount": "100.00",
          "kind": "refund",
          "gateway": "gift_card",
          "status": "success",
          "message": null,
          "created_at": "2018-07-11T14:44:38-04:00",
          "test": false,
          "authorization": null,
          "currency": "USD",
          "location_id": null,
          "user_id": null,
          "parent_id": 1072844675,
          "device_id": null,
          "receipt": {
            "gift_card_id": 48394658,
            "gift_card_last_characters": "0d0d"
          },
          "error_code": null,
          "source_name": "755357713",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/1072844677"
        }
      ],
      "order_adjustments": [
        {
          "id": 1030976842,
          "order_id": 450789469,
          "refund_id": 929361463,
          "amount": "89.64",
          "tax_amount": "0.00",
          "kind": "refund_discrepancy",
          "reason": "Refund discrepancy"
        }
      ]
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2018-07-11T14:37:16-04:00",
    "updated_at": "2018-07-11T14:37:16-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "41.94",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "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
    }
  }
},
  "notice": "Order has been canceled"
}

Canceling an order that has fulfillments fails with an error

POST /admin/orders/#{order_id}/cancel.json
{
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2018-07-11T14:44:40-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "authorize_net",
  "test": false,
  "total_price": "409.94",
  "subtotal_price": "398.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "authorized",
  "confirmed": true,
  "total_discounts": "0.00",
  "total_line_items_price": "398.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "409.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": null,
  "landing_site_ref": null,
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax"
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://checkout.local/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=4c6ea22c84bcb2afcba150a99c92d446",
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "price": "199.00",
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 0,
      "grams": 200,
      "total_discount": "0.00",
      "fulfillment_status": "fulfilled",
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "price": "199.00",
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "total_discount": "0.00",
      "fulfillment_status": null,
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "price": "199.00",
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "total_discount": "0.00",
      "fulfillment_status": null,
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "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"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "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"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "success",
      "created_at": "2018-07-11T14:37:16-04:00",
      "service": "manual",
      "updated_at": "2018-07-11T14:44:40-04:00",
      "tracking_company": "UPS",
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track",
      "tracking_urls": [
        "http://wwwapps.ups.com/etracking/tracking.cgi?InquiryNumber1=1Z2345&TypeOfInquiryNumber=T&AcceptUPSLicenseAgreement=yes&submit=Track"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "grams": 200,
          "total_discount": "0.00",
          "fulfillment_status": "fulfilled",
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 509562969,
      "order_id": 450789469,
      "created_at": "2018-07-11T14:37:16-04:00",
      "note": "it broke during shipping",
      "user_id": 799407056,
      "processed_at": "2018-07-11T14:37:16-04:00",
      "restock": true,
      "admin_graphql_api_id": "gid://shopify/Refund/509562969",
      "refund_line_items": [
        {
          "id": 104689539,
          "quantity": 1,
          "line_item_id": 703073504,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 195.67,
          "total_tax": 3.98,
          "line_item": {
            "id": 703073504,
            "variant_id": 457924702,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "price": "199.00",
            "sku": "IPOD2008BLACK",
            "variant_title": "black",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "total_discount": "0.00",
            "fulfillment_status": null,
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06
              }
            ]
          }
        },
        {
          "id": 709875399,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 195.66,
          "total_tax": 3.98,
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "price": "199.00",
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 200,
            "total_discount": "0.00",
            "fulfillment_status": "fulfilled",
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 179259969,
          "order_id": 450789469,
          "amount": "209.00",
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": null,
          "created_at": "2005-08-05T12:59:12-04:00",
          "test": false,
          "authorization": "authorization-key",
          "currency": "USD",
          "location_id": null,
          "user_id": null,
          "parent_id": 801038806,
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "web",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
        }
      ],
      "order_adjustments": []
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2018-07-11T14:37:16-04:00",
    "updated_at": "2018-07-11T14:37:16-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "41.94",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "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
    }
  }
},
  "error": "Cannot cancel a paid and fulfilled order"
}
POST /admin/orders.json

Creates an order.

When you create an order, you can include the following option parameters in the body of the request:

  • send_receipt: Whether to send an order confirmation to the customer.
  • send_fulfillment_receipt: Whether to send a shipping confirmation to the customer.
  • inventory_behaviour: The behaviour to use when updating inventory. (default: bypass)
    • bypass: Do not claim inventory.
    • decrement_ignoring_policy: Ignore the product's inventory policy and claim amounts no matter what.
    • decrement_obeying_policy: Obey the product's inventory policy.

Create a simple order with only a product variant ID

POST /admin/orders.json
{
  "order": {
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459966,
    "email": "",
    "closed_at": null,
    "created_at": "2018-07-11T14:44:42-04:00",
    "updated_at": "2018-07-11T14:44:42-04:00",
    "number": 2,
    "note": null,
    "token": "7267d44bf22f18a4298e87ac4a37defc",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": null,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2018-07-11T14:44:42-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [],
    "tags": "",
    "contact_email": null,
    "order_status_url": "https://checkout.local/690933842/orders/7267d44bf22f18a4298e87ac4a37defc/authenticate?key=4c583161d18e4c5241a39e6e87616d2f",
    "admin_graphql_api_id": "gid://shopify/Order/1073459966",
    "line_items": [
      {
        "id": 1071823174,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "manual",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 567,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823174",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": []
  }
}

Create a simple order, sending an order confirmation and a shipping confirmation to the customer

POST /admin/orders.json
{
  "order": {
    "email": "foo@example.com",
    "fulfillment_status": "fulfilled",
    "send_receipt": true,
    "send_fulfillment_receipt": true,
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459967,
    "email": "foo@example.com",
    "closed_at": null,
    "created_at": "2018-07-11T14:44:42-04:00",
    "updated_at": "2018-07-11T14:44:43-04:00",
    "number": 2,
    "note": null,
    "token": "246cd149583c1022a70345afaf9a991e",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": null,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2018-07-11T14:44:42-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": "fulfilled",
    "tax_lines": [],
    "tags": "",
    "contact_email": "foo@example.com",
    "order_status_url": "https://checkout.local/690933842/orders/246cd149583c1022a70345afaf9a991e/authenticate?key=83f7172c5228575ae8a35bb4c67fe268",
    "admin_graphql_api_id": "gid://shopify/Order/1073459967",
    "line_items": [
      {
        "id": 1071823175,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "manual",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "grams": 567,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823175",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [
      {
        "id": 1022782884,
        "order_id": 1073459967,
        "status": "success",
        "created_at": "2018-07-11T14:44:43-04:00",
        "service": "manual",
        "updated_at": "2018-07-11T14:44:43-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 487838322,
        "tracking_number": null,
        "tracking_numbers": [],
        "tracking_url": null,
        "tracking_urls": [],
        "receipt": {},
        "name": "#1002.1",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/1022782884",
        "line_items": [
          {
            "id": 1071823175,
            "variant_id": 447654529,
            "title": "IPod Touch 8GB",
            "quantity": 1,
            "price": "199.00",
            "sku": "IPOD2009BLACK",
            "variant_title": "Black",
            "vendor": "Apple",
            "fulfillment_service": "manual",
            "product_id": 921728736,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Touch 8GB - Black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 567,
            "total_discount": "0.00",
            "fulfillment_status": "fulfilled",
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/1071823175",
            "tax_lines": []
          }
        ]
      }
    ],
    "refunds": [],
    "customer": {
      "id": 1073339466,
      "email": "foo@example.com",
      "accepts_marketing": false,
      "created_at": "2018-07-11T14:44:42-04:00",
      "updated_at": "2018-07-11T14:44:43-04:00",
      "first_name": null,
      "last_name": null,
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "0.00",
      "last_order_id": 1073459967,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "admin_graphql_api_id": "gid://shopify/Customer/1073339466"
    }
  }
}

Create a simple order without sending an order receipt or a fulfillment receipt

POST /admin/orders.json
{
  "order": {
    "email": "foo@example.com",
    "fulfillment_status": "fulfilled",
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459968,
    "email": "foo@example.com",
    "closed_at": null,
    "created_at": "2018-07-11T14:44:57-04:00",
    "updated_at": "2018-07-11T14:44:58-04:00",
    "number": 2,
    "note": null,
    "token": "49fd0df60976a6fe9ea585eb1aba2948",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": null,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2018-07-11T14:44:57-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": "fulfilled",
    "tax_lines": [],
    "tags": "",
    "contact_email": "foo@example.com",
    "order_status_url": "https://checkout.local/690933842/orders/49fd0df60976a6fe9ea585eb1aba2948/authenticate?key=32f5f213efad6378a8a278e3ab6d8709",
    "admin_graphql_api_id": "gid://shopify/Order/1073459968",
    "line_items": [
      {
        "id": 1071823176,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "manual",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "grams": 567,
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823176",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [
      {
        "id": 1022782885,
        "order_id": 1073459968,
        "status": "success",
        "created_at": "2018-07-11T14:44:57-04:00",
        "service": "manual",
        "updated_at": "2018-07-11T14:44:58-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 487838322,
        "tracking_number": null,
        "tracking_numbers": [],
        "tracking_url": null,
        "tracking_urls": [],
        "receipt": {},
        "name": "#1002.1",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/1022782885",
        "line_items": [
          {
            "id": 1071823176,
            "variant_id": 447654529,
            "title": "IPod Touch 8GB",
            "quantity": 1,
            "price": "199.00",
            "sku": "IPOD2009BLACK",
            "variant_title": "Black",
            "vendor": "Apple",
            "fulfillment_service": "manual",
            "product_id": 921728736,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Touch 8GB - Black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 567,
            "total_discount": "0.00",
            "fulfillment_status": "fulfilled",
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/1071823176",
            "tax_lines": []
          }
        ]
      }
    ],
    "refunds": [],
    "customer": {
      "id": 1073339467,
      "email": "foo@example.com",
      "accepts_marketing": false,
      "created_at": "2018-07-11T14:44:57-04:00",
      "updated_at": "2018-07-11T14:44:58-04:00",
      "first_name": null,
      "last_name": null,
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "0.00",
      "last_order_id": 1073459968,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "admin_graphql_api_id": "gid://shopify/Customer/1073339467"
    }
  }
}

Create a comprehensive order

POST /admin/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "Big Brown Bear Boots",
        "price": 74.99,
        "grams": "1300",
        "quantity": 3,
        "tax_lines": [
          {
            "price": 13.5,
            "rate": 0.06,
            "title": "State tax"
          }
        ]
      }
    ],
    "transactions": [
      {
        "kind": "sale",
        "status": "success",
        "amount": 238.47
      }
    ],
    "total_tax": 13.5,
    "currency": "EUR"
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459969,
    "email": "",
    "closed_at": null,
    "created_at": "2018-07-11T14:44:58-04:00",
    "updated_at": "2018-07-11T14:44:58-04:00",
    "number": 2,
    "note": null,
    "token": "f8ed97cf78bcdb7f7016bf69e29bae0f",
    "gateway": "",
    "test": false,
    "total_price": "238.47",
    "subtotal_price": "224.97",
    "total_weight": null,
    "total_tax": "13.50",
    "taxes_included": false,
    "currency": "EUR",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "224.97",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "340.54",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2018-07-11T14:44:58-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [
      ""
    ],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "13.50",
        "rate": 0.06,
        "title": "State tax"
      }
    ],
    "tags": "",
    "contact_email": null,
    "order_status_url": "https://checkout.local/690933842/orders/f8ed97cf78bcdb7f7016bf69e29bae0f/authenticate?key=c7784da19df2413f94af20eb61edec16",
    "admin_graphql_api_id": "gid://shopify/Order/1073459969",
    "line_items": [
      {
        "id": 1071823177,
        "variant_id": null,
        "title": "Big Brown Bear Boots",
        "quantity": 3,
        "price": "74.99",
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "Big Brown Bear Boots",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 3,
        "grams": 1300,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823177",
        "tax_lines": [
          {
            "title": "State tax",
            "price": "13.50",
            "rate": 0.06
          }
        ]
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": []
  }
}

Create an order with tax lines split across taxable line items

POST /admin/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "Red Leather Coat",
        "price": 129.99,
        "grams": "1700",
        "quantity": 1
      },
      {
        "title": "Blue Suede Shoes",
        "price": 85.95,
        "grams": "750",
        "quantity": 1,
        "taxable": false
      },
      {
        "title": "Raspberry Beret",
        "price": 19.99,
        "grams": "320",
        "quantity": 2
      }
    ],
    "tax_lines": [
      {
        "price": 10.2,
        "rate": 0.06,
        "title": "State tax"
      },
      {
        "price": 4.25,
        "rate": 0.025,
        "title": "County tax"
      }
    ],
    "total_tax": 14.45
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459970,
    "email": "",
    "closed_at": null,
    "created_at": "2018-07-11T14:44:59-04:00",
    "updated_at": "2018-07-11T14:44:59-04:00",
    "number": 2,
    "note": null,
    "token": "3f06b867680c9f0d99de373aac821197",
    "gateway": "",
    "test": false,
    "total_price": "270.37",
    "subtotal_price": "255.92",
    "total_weight": null,
    "total_tax": "14.45",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "255.92",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "270.37",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2018-07-11T14:44:59-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "10.20",
        "rate": 0.06,
        "title": "State tax"
      },
      {
        "price": "4.25",
        "rate": 0.025,
        "title": "County tax"
      }
    ],
    "tags": "",
    "contact_email": null,
    "order_status_url": "https://checkout.local/690933842/orders/3f06b867680c9f0d99de373aac821197/authenticate?key=b1dfa57b5813df137b40d88d628f7f9c",
    "admin_graphql_api_id": "gid://shopify/Order/1073459970",
    "line_items": [
      {
        "id": 1071823178,
        "variant_id": null,
        "title": "Red Leather Coat",
        "quantity": 1,
        "price": "129.99",
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "Red Leather Coat",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 1,
        "grams": 1700,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823178",
        "tax_lines": [
          {
            "title": "State tax",
            "price": "7.81",
            "rate": 0.06
          },
          {
            "title": "County tax",
            "price": "3.26",
            "rate": 0.025
          }
        ]
      },
      {
        "id": 1071823179,
        "variant_id": null,
        "title": "Blue Suede Shoes",
        "quantity": 1,
        "price": "85.95",
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": false,
        "gift_card": false,
        "name": "Blue Suede Shoes",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 1,
        "grams": 750,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823179",
        "tax_lines": []
      },
      {
        "id": 1071823180,
        "variant_id": null,
        "title": "Raspberry Beret",
        "quantity": 2,
        "price": "19.99",
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "Raspberry Beret",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 2,
        "grams": 320,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823180",
        "tax_lines": [
          {
            "title": "State tax",
            "price": "2.39",
            "rate": 0.06
          },
          {
            "title": "County tax",
            "price": "0.99",
            "rate": 0.025
          }
        ]
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": []
  }
}

Creating an order with tax lines both on line items and on the order fails and returns an error

POST /admin/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "Clicky Keyboard",
        "price": 99.99,
        "grams": "600",
        "quantity": 1,
        "tax_lines": [
          {
            "price": 1.0,
            "rate": 0.01,
            "title": "Keyboard tax"
          }
        ]
      }
    ],
    "tax_lines": [
      {
        "price": 6.0,
        "rate": 0.06,
        "title": "State tax"
      }
    ]
  }
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "errors": {
    "order": [
      "Tax lines must be associated with either order or line item but not both"
    ]
  }
}

Create a pending order with an existing customer

POST /admin/orders.json
{
  "order": {
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ],
    "customer": {
      "id": 207119551
    },
    "financial_status": "pending"
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459971,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2018-07-11T14:45:00-04:00",
    "updated_at": "2018-07-11T14:45:00-04:00",
    "number": 2,
    "note": null,
    "token": "ccab44a345618b555173f255d3bec686",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": null,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "pending",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2018-07-11T14:45:00-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://checkout.local/690933842/orders/ccab44a345618b555173f255d3bec686/authenticate?key=b507fe7d8d48f5b7dca9bc1e068f7474",
    "admin_graphql_api_id": "gid://shopify/Order/1073459971",
    "line_items": [
      {
        "id": 1071823181,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "manual",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 567,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823181",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": [],
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2018-07-11T14:37:16-04:00",
      "updated_at": "2018-07-11T14:45:00-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 2,
      "state": "disabled",
      "total_spent": "41.94",
      "last_order_id": 1073459971,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "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 partially paid order with a new customer and addresses

POST /admin/orders.json
{
  "order": {
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ],
    "customer": {
      "first_name": "Paul",
      "last_name": "Norman",
      "email": "paul.norman@example.com"
    },
    "billing_address": {
      "first_name": "John",
      "last_name": "Smith",
      "address1": "123 Fake Street",
      "phone": "555-555-5555",
      "city": "Fakecity",
      "province": "Ontario",
      "country": "Canada",
      "zip": "K2P 1L4"
    },
    "shipping_address": {
      "first_name": "Jane",
      "last_name": "Smith",
      "address1": "123 Fake Street",
      "phone": "777-777-7777",
      "city": "Fakecity",
      "province": "Ontario",
      "country": "Canada",
      "zip": "K2P 1L4"
    },
    "email": "jane@example.com",
    "transactions": [
      {
        "kind": "authorization",
        "status": "success",
        "amount": 50.0
      }
    ],
    "financial_status": "partially_paid"
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459972,
    "email": "jane@example.com",
    "closed_at": null,
    "created_at": "2018-07-11T14:45:01-04:00",
    "updated_at": "2018-07-11T14:45:01-04:00",
    "number": 2,
    "note": null,
    "token": "f9c3ce138c4e103019219e2d73a56a9c",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": null,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2018-07-11T14:45:01-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [
      ""
    ],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [],
    "tags": "",
    "contact_email": "jane@example.com",
    "order_status_url": "https://checkout.local/690933842/orders/f9c3ce138c4e103019219e2d73a56a9c/authenticate?key=51f58397b6afdd6a4c884cd6a2ae1c99",
    "admin_graphql_api_id": "gid://shopify/Order/1073459972",
    "line_items": [
      {
        "id": 1071823182,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "price": "199.00",
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "manual",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 567,
        "total_discount": "0.00",
        "fulfillment_status": null,
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823182",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "billing_address": {
      "first_name": "John",
      "address1": "123 Fake Street",
      "phone": "555-555-5555",
      "city": "Fakecity",
      "zip": "K2P 1L4",
      "province": "Ontario",
      "country": "Canada",
      "last_name": "Smith",
      "address2": null,
      "company": null,
      "latitude": null,
      "longitude": null,
      "name": "John Smith",
      "country_code": "CA",
      "province_code": "ON"
    },
    "shipping_address": {
      "first_name": "Jane",
      "address1": "123 Fake Street",
      "phone": "777-777-7777",
      "city": "Fakecity",
      "zip": "K2P 1L4",
      "province": "Ontario",
      "country": "Canada",
      "last_name": "Smith",
      "address2": null,
      "company": null,
      "latitude": null,
      "longitude": null,
      "name": "Jane Smith",
      "country_code": "CA",
      "province_code": "ON"
    },
    "fulfillments": [],
    "refunds": [],
    "customer": {
      "id": 1073339468,
      "email": "paul.norman@example.com",
      "accepts_marketing": false,
      "created_at": "2018-07-11T14:45:01-04:00",
      "updated_at": "2018-07-11T14:45:01-04:00",
      "first_name": "John",
      "last_name": "Smith",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "0.00",
      "last_order_id": 1073459972,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "admin_graphql_api_id": "gid://shopify/Customer/1073339468",
      "default_address": {
        "id": 1053317302,
        "customer_id": 1073339468,
        "first_name": "Jane",
        "last_name": "Smith",
        "company": null,
        "address1": "123 Fake Street",
        "address2": null,
        "city": "Fakecity",
        "province": "Ontario",
        "country": "Canada",
        "zip": "K2P 1L4",
        "phone": "777-777-7777",
        "name": "Jane Smith",
        "province_code": "ON",
        "country_code": "CA",
        "country_name": "Canada",
        "default": true
      }
    }
  }
}
PUT /admin/orders/450789469.json
Updates an order

Add a note to order

PUT /admin/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "note": "Customer contacted us about a custom engraving on this iPod"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2018-07-11T14:45:02-04:00",
    "number": 1,
    "note": "Customer contacted us about a custom engraving on this iPod",
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "409.94",
    "subtotal_price": "398.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "authorized",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "398.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "409.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name":