The REST Admin API is a legacy API as of October 1, 2024. All apps and integrations should be built with the GraphQL Admin API. For details and migration steps, visit our migration guide.
An order is a customer's request to purchase one or more products from a shop. You can create, retrieve, update, and delete orders using the Order resource.
Usage notes
- When you create an order through the API, no payment information is collected, and no transaction is performed.
- After an order is created, you can change only a few of its attributes using the API. You can't change the items or the quantities in an order using the REST API, but you can change them using the GraphQL Admin API.
- You can add metafields to the Order resource.
- You can allow merchants to create orders manually by using the DraftOrder resource.
Caution
You can't use the Order resource to create a new checkout for an individual store. To create a checkout, you need to use the Checkout API or an SDK powered by the Storefront API, such as the JavaScript Buy SDK, iOS Buy SDK, or Android Buy SDK.
Caution
Only the last 60 days' worth of orders from a store are 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
.
Only use this data if it's required for your app's functionality. Shopify will restrict access to scopes for apps that don't have a legitimate use for the associated data.
- post/admin
/api /2024-10 /orders.json Create an order - post/admin
/api /2024-10 /orders /{order_id} /cancel.json Cancel an order - post/admin
/api /2024-10 /orders /{order_id} /close.json Close an order - post/admin
/api /2024-10 /orders /{order_id} /open.json Re-open a closed order - get/admin
/api /2024-10 /orders.json?status=any Retrieve a list of orders - get/admin
/api /2024-10 /orders /{order_id}.json?fields=id,line_items,name,total_price Retrieve a specific order - get/admin
/api /2024-10 /orders /count.json?status=any Retrieve an order count - put/admin
/api /2024-10 /orders /{order_id}.json Update an order - del/admin
/api /2024-10 /orders /{order_id}.json Delete an order
The Order resource
null
if the order isn't canceled.Information about the browser that the customer used when they placed their order:
null
if the order isn't closed.Represents information about the purchasing company for the order. null
will be returned if there is no purchasing company.
{ "app_id": 1966818, "billing_address": { "address1": "2259 Park Ct", "address2": "Apartment 5", "city": "Drayton Valley", "company": null, "country": "Canada", "first_name": "Christopher", "last_name": "Gorski", "phone": "(555)555-5555", "province": "Alberta", "zip": "T0E 0M0", "name": "Christopher Gorski", "province_code": "AB", "country_code": "CA", "latitude": "45.41634", "longitude": "-75.6868" }, "browser_ip": "216.191.105.146", "buyer_accepts_marketing": false, "cancel_reason": "customer", "cancelled_at": null, "cart_token": "68778783ad298f1c80c3bafcddeea", "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c", "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" }, "closed_at": "2008-01-10T11:00:00-05:00", "company": { "id": 182772, "location_id": 753095 }, "confirmation_number": "TLQDA3NN9", "confirmed": false, "created_at": "2008-01-10T11:00:00-05:00", "currency": "USD", "current_total_additional_fees_set": { "shop_money": { "amount": "1.23", "currency_code": "CAD" }, "presentment_money": { "amount": "0.85", "currency_code": "EUR" } }, "current_total_discounts": "10.00", "current_total_discounts_set": { "current_total_discounts_set": { "shop_money": { "amount": "10.00", "currency_code": "CAD" }, "presentment_money": { "amount": "5.00", "currency_code": "EUR" } } }, "current_total_duties_set": { "current_total_duties_set": { "shop_money": { "amount": "164.86", "currency_code": "CAD" }, "presentment_money": { "amount": "105.31", "currency_code": "EUR" } } }, "current_total_price": "10.00", "current_total_price_set": { "current_total_price_set": { "shop_money": { "amount": "30.00", "currency_code": "CAD" }, "presentment_money": { "amount": "20.00", "currency_code": "EUR" } } }, "current_subtotal_price": "10.00", "current_subtotal_price_set": { "current_subtotal_price_set": { "shop_money": { "amount": "30.00", "currency_code": "CAD" }, "presentment_money": { "amount": "20.00", "currency_code": "EUR" } } }, "current_total_tax": "10.00", "current_total_tax_set": { "current_total_tax_set": { "shop_money": { "amount": "30.00", "currency_code": "CAD" }, "presentment_money": { "amount": "20.00", "currency_code": "EUR" } } }, "customer": { "id": 207119551, "email": "bob.norman@mail.example.com", "accepts_marketing": false, "created_at": "2012-03-13T16:09:55-04:00", "updated_at": "2012-03-13T16:09:55-04:00", "first_name": "Bob", "last_name": "Norman", "state": "disabled", "note": null, "verified_email": true, "multipass_identifier": null, "tax_exempt": false, "tax_exemptions": {}, "phone": "+13125551212", "tags": "loyal", "currency": "USD", "addresses": {}, "admin_graphql_api_id": "gid://shopify/Customer/207119551", "default_address": {} }, "customer_locale": "en-CA", "discount_applications": [ { "type": "manual", "title": "custom discount", "description": "customer deserved it", "value": "2.0", "value_type": "fixed_amount", "allocation_method": "across", "target_selection": "explicit", "target_type": "line_item" }, { "type": "script", "description": "my scripted discount", "value": "5.0", "value_type": "fixed_amount", "allocation_method": "across", "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" } ], "discount_codes": [ { "code": "SPRING30", "amount": "30.00", "type": "fixed_amount" } ], "email": "bob.norman@mail.example.com", "estimated_taxes": false, "financial_status": "authorized", "fulfillments": [ { "created_at": "2012-03-13T16:09:54-04:00", "id": 255858046, "order_id": 450789469, "status": "failure", "tracking_company": "USPS", "tracking_number": "1Z1234512345123456", "updated_at": "2012-05-01T14:22:25-04:00" } ], "fulfillment_status": "partial", "gateway": "shopify_payments", "id": 450789469, "landing_site": "http://www.example.com?source=abc", "line_items": [ { "attributed_staffs": [ { "id": "gid://shopify/StaffMember/2108187", "quantity": 1 } ], "fulfillable_quantity": 1, "fulfillment_service": "amazon", "fulfillment_status": "fulfilled", "grams": 500, "id": 669751112, "price": "199.99", "product_id": 7513594, "quantity": 1, "current_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, "price_set": { "shop_money": { "amount": "199.99", "currency_code": "USD" }, "presentment_money": { "amount": "173.30", "currency_code": "EUR" } }, "properties": [ { "name": "custom engraving", "value": "Happy Birthday Mom!" } ], "taxable": true, "tax_lines": [ { "title": "HST", "price": "25.81", "price_set": { "shop_money": { "amount": "25.81", "currency_code": "USD" }, "presentment_money": { "amount": "20.15", "currency_code": "EUR" } }, "channel_liable": true, "rate": 0.13 } ], "total_discount": "5.00", "total_discount_set": { "shop_money": { "amount": "5.00", "currency_code": "USD" }, "presentment_money": { "amount": "4.30", "currency_code": "EUR" } }, "discount_allocations": [ { "amount": "5.00", "discount_application_index": 2, "amount_set": { "shop_money": { "amount": "5.00", "currency_code": "USD" }, "presentment_money": { "amount": "3.96", "currency_code": "EUR" } } } ], "origin_location": { "id": 1390592786454, "country_code": "CA", "province_code": "ON", "name": "Apple", "address1": "700 West Georgia Street", "address2": "1500", "city": "Toronto", "zip": "V7Y 1G5" }, "duties": [ { "id": "2", "harmonized_system_code": "520300", "country_code_of_origin": "CA", "shop_money": { "amount": "164.86", "currency_code": "CAD" }, "presentment_money": { "amount": "105.31", "currency_code": "EUR" }, "tax_lines": [ { "title": "VAT", "price": "16.486", "rate": 0.1, "price_set": { "shop_money": { "amount": "16.486", "currency_code": "CAD" }, "presentment_money": { "amount": "10.531", "currency_code": "EUR" } }, "channel_liable": true } ], "admin_graphql_api_id": "gid://shopify/Duty/2" } ] } ], "location_id": 49202758, "merchant_business_entity_id": "MTE", "merchant_of_record_app_id": 123456, "name": "#1001", "note": "Customer changed their mind.", "note_attributes": [ { "name": "custom name", "value": "custom value" } ], "number": 1, "order_number": 1001, "original_total_additional_fees_set": { "shop_money": { "amount": "1.23", "currency_code": "CAD" }, "presentment_money": { "amount": "0.85", "currency_code": "EUR" } }, "original_total_duties_set": { "original_total_duties_set": { "shop_money": { "amount": "164.86", "currency_code": "CAD" }, "presentment_money": { "amount": "105.31", "currency_code": "EUR" } } }, "payment_terms": { "amount": 70, "currency": "CAD", "payment_terms_name": "NET_30", "payment_terms_type": "NET", "due_in_days": 30, "payment_schedules": [ { "amount": 70, "currency": "CAD", "issued_at": "2020-07-29T13:02:43-04:00", "due_at": "2020-08-29T13:02:43-04:00", "completed_at": "null", "expected_payment_method": "shopify_payments" } ] }, "payment_gateway_names": [ "authorize_net", "Cash on Delivery (COD)" ], "phone": "+557734881234", "po_number": "PO#123456789", "presentment_currency": "CAD", "processed_at": "2008-01-10T11:00:00-05:00", "referring_site": "http://www.anexample.com", "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", "refund_line_items": [], "transactions": [], "order_adjustments": [] } ], "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" }, "shipping_lines": [ { "code": "INT.TP", "price": "4.00", "price_set": { "shop_money": { "amount": "4.00", "currency_code": "USD" }, "presentment_money": { "amount": "3.17", "currency_code": "EUR" } }, "discounted_price": "4.00", "discounted_price_set": { "shop_money": { "amount": "4.00", "currency_code": "USD" }, "presentment_money": { "amount": "3.17", "currency_code": "EUR" } }, "source": "canada_post", "title": "Small Packet International Air", "tax_lines": [], "carrier_identifier": "third_party_carrier_identifier", "requested_fulfillment_service_id": "third_party_fulfillment_service_id", "is_removed": false } ], "source_name": "instagram", "source_identifier": "ORDERID-123", "source_url": "{URL_to_order}", "subtotal_price": "398.00", "subtotal_price_set": { "shop_money": { "amount": "141.99", "currency_code": "CAD" }, "presentment_money": { "amount": "90.95", "currency_code": "EUR" } }, "tags": "imported, vip", "tax_lines": [ { "price": 11.94, "rate": 0.06, "title": "State Tax", "channel_liable": true } ], "taxes_included": false, "duties_included": false, "test": true, "token": "b1946ac92492d2347c6235b4d2611184", "total_cash_rounding_payment_adjustment_set": { "shop_money": { "amount": "-0.02", "currency_code": "CAD" }, "presentment_money": { "amount": "-0.02", "currency_code": "CAD" } }, "total_cash_rounding_refund_adjustment_set": { "shop_money": { "amount": "0.01", "currency_code": "CAD" }, "presentment_money": { "amount": "0.01", "currency_code": "CAD" } }, "total_discounts": "0.00", "total_discounts_set": { "shop_money": { "amount": "0.00", "currency_code": "CAD" }, "presentment_money": { "amount": "0.00", "currency_code": "EUR" } }, "total_line_items_price": "398.00", "total_line_items_price_set": { "shop_money": { "amount": "141.99", "currency_code": "CAD" }, "presentment_money": { "amount": "90.95", "currency_code": "EUR" } }, "total_outstanding": "5.00", "total_price": "409.94", "total_price_set": { "shop_money": { "amount": "164.86", "currency_code": "CAD" }, "presentment_money": { "amount": "105.31", "currency_code": "EUR" } }, "total_shipping_price_set": { "shop_money": { "amount": "30.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_tax": "11.94", "total_tax_set": { "shop_money": { "amount": "18.87", "currency_code": "CAD" }, "presentment_money": { "amount": "11.82", "currency_code": "EUR" } }, "total_tip_received": "4.87", "total_weight": 300, "updated_at": "2012-08-24T14:02:15-04:00", "user_id": 31522279, "order_status_url": { "order_status_url": "https://checkout.shopify.com/112233/checkouts/4207896aad57dfb159/thank_you_token?key=753621327b9e8a64789651bf221dfe35" } }
postCreate an order
orders
access scope.
Creates an order.
By default, product inventory is not claimed when creating an order.
There are additional optional parameters that can be specified in the body of the request when creating an order:
- 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 inventory.
- decrement_obeying_policy: Follow the product's inventory policy and claim inventory, if possible.
- send_receipt: Whether to send an order confirmation to the customer. (default:
false
)
- send_fulfillment_receipt: Whether to send a shipping confirmation to the customer. (default:
false
)
curl -d '{"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"}}' \ -X POST "https://your-development-store.myshopify.com/admin/api/2024-10/orders.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json"
HTTP/1.1 201 Created { "order": { "id": 1073459990, "admin_graphql_api_id": "gid://shopify/Order/1073459990", "app_id": 755357713, "browser_ip": null, "buyer_accepts_marketing": false, "cancel_reason": null, "cancelled_at": null, "cart_token": null, "checkout_id": null, "checkout_token": null, "client_details": null, "closed_at": null, "confirmation_number": "ECTTIFP75", "confirmed": true, "contact_email": null, "created_at": "2024-10-01T13:47:28-04:00", "currency": "EUR", "current_subtotal_price": "224.97", "current_subtotal_price_set": { "shop_money": { "amount": "224.97", "currency_code": "EUR" }, "presentment_money": { "amount": "224.97", "currency_code": "EUR" } }, "current_total_additional_fees_set": null, "current_total_discounts": "0.00", "current_total_discounts_set": { "shop_money": { "amount": "0.00", "currency_code": "EUR" }, "presentment_money": { "amount": "0.00", "currency_code": "EUR" } }, "current_total_duties_set": null, "current_total_price": "238.47", "current_total_price_set": { "shop_money": { "amount": "238.47", "currency_code": "EUR" }, "presentment_money": { "amount": "238.47", "currency_code": "EUR" } }, "current_total_tax": "13.50", "current_total_tax_set": { "shop_money": { "amount": "13.50", "currency_code": "EUR" }, "presentment_money": { "amount": "13.50", "currency_code": "EUR" } }, "customer_locale": null, "device_id": null, "discount_codes": [], "duties_included": false, "email": "", "estimated_taxes": false, "financial_status": "paid", "fulfillment_status": null, "landing_site": null, "landing_site_ref": null, "location_id": null, "merchant_business_entity_id": "MTU0ODM4MDAwOQ", "merchant_of_record_app_id": null, "name": "#1002", "note": null, "note_attributes": [], "number": 2, "order_number": 1002, "order_status_url": "https://jsmith.myshopify.com/548380009/orders/d4b7fb0cdb15e2190ffb5960cfbb8ed0/authenticate?key=7ff6987f33f02675d5dc7a88b4092a70", "original_total_additional_fees_set": null, "original_total_duties_set": null, "payment_gateway_names": [ "" ], "phone": null, "po_number": null, "presentment_currency": "EUR", "processed_at": "2024-10-01T13:47:28-04:00", "reference": null, "referring_site": null, "source_identifier": null, "source_name": "755357713", "source_url": null, "subtotal_price": "224.97", "subtotal_price_set": { "shop_money": { "amount": "224.97", "currency_code": "EUR" }, "presentment_money": { "amount": "224.97", "currency_code": "EUR" } }, "tags": "", "tax_exempt": false, "tax_lines": [ { "price": "13.50", "rate": 0.06, "title": "State tax", "price_set": { "shop_money": { "amount": "13.50", "currency_code": "EUR" }, "presentment_money": { "amount": "13.50", "currency_code": "EUR" } }, "channel_liable": false } ], "taxes_included": false, "test": false, "token": "d4b7fb0cdb15e2190ffb5960cfbb8ed0", "total_cash_rounding_payment_adjustment_set": { "shop_money": { "amount": "0.00", "currency_code": "EUR" }, "presentment_money": { "amount": "0.00", "currency_code": "EUR" } }, "total_cash_rounding_refund_adjustment_set": { "shop_money": { "amount": "0.00", "currency_code": "EUR" }, "presentment_money": { "amount": "0.00", "currency_code": "EUR" } }, "total_discounts": "0.00", "total_discounts_set": { "shop_money": { "amount": "0.00", "currency_code": "EUR" }, "presentment_money": { "amount": "0.00", "currency_code": "EUR" } }, "total_line_items_price": "224.97", "total_line_items_price_set": { "shop_money": { "amount": "224.97", "currency_code": "EUR" }, "presentment_money": { "amount": "224.97", "currency_code": "EUR" } }, "total_outstanding": "0.00", "total_price": "238.47", "total_price_set": { "shop_money": { "amount": "238.47", "currency_code": "EUR" }, "presentment_money": { "amount": "238.47", "currency_code": "EUR" } }, "total_shipping_price_set": { "shop_money": { "amount": "0.00", "currency_code": "EUR" }, "presentment_money": { "amount": "0.00", "currency_code": "EUR" } }, "total_tax": "13.50", "total_tax_set": { "shop_money": { "amount": "13.50", "currency_code": "EUR" }, "presentment_money": { "amount": "13.50", "currency_code": "EUR" } }, "total_tip_received": "0.00", "total_weight": 0, "updated_at": "2024-10-01T13:47:28-04:00", "user_id": null, "billing_address": null, "customer": null, "discount_applications": [], "fulfillments": [], "line_items": [ { "id": 1071823202, "admin_graphql_api_id": "gid://shopify/LineItem/1071823202", "attributed_staffs": [], "current_quantity": 3, "fulfillable_quantity": 3, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 1300, "name": "Big Brown Bear Boots", "price": "74.99", "price_set": { "shop_money": { "amount": "74.99", "currency_code": "EUR" }, "presentment_money": { "amount": "74.99", "currency_code": "EUR" } }, "product_exists": false, "product_id": null, "properties": [], "quantity": 3, "requires_shipping": true, "sku": null, "taxable": true, "title": "Big Brown Bear Boots", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "EUR" }, "presentment_money": { "amount": "0.00", "currency_code": "EUR" } }, "variant_id": null, "variant_inventory_management": null, "variant_title": null, "vendor": null, "tax_lines": [ { "channel_liable": false, "price": "13.50", "price_set": { "shop_money": { "amount": "13.50", "currency_code": "EUR" }, "presentment_money": { "amount": "13.50", "currency_code": "EUR" } }, "rate": 0.06, "title": "State tax" } ], "duties": [], "discount_allocations": [] } ], "payment_terms": null, "refunds": [], "shipping_address": null, "shipping_lines": [] } }
postCancel an order
buyer_membership_orders
, orders
, marketplace_orders
.
amount
property is provided.customer
, inventory
, fraud
, declined
, and other
.)curl -d '{}' \ -X POST "https://your-development-store.myshopify.com/admin/api/2024-10/orders/450789469/cancel.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json"
HTTP/1.1 200 OK { "order": { "id": 450789469, "admin_graphql_api_id": "gid://shopify/Order/450789469", "app_id": null, "browser_ip": "0.0.0.0", "buyer_accepts_marketing": false, "cancel_reason": "other", "cancelled_at": "2024-10-01T13:47:32-04:00", "cart_token": "68778783ad298f1c80c3bafcddeea02f", "checkout_id": 901414060, "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c", "client_details": { "accept_language": null, "browser_height": null, "browser_ip": "0.0.0.0", "browser_width": null, "session_hash": null, "user_agent": null }, "closed_at": null, "confirmation_number": null, "confirmed": true, "contact_email": "bob.norman@mail.example.com", "created_at": "2008-01-10T11:00:00-05:00", "currency": "USD", "current_subtotal_price": "195.67", "current_subtotal_price_set": { "shop_money": { "amount": "195.67", "currency_code": "USD" }, "presentment_money": { "amount": "195.67", "currency_code": "USD" } }, "current_total_additional_fees_set": null, "current_total_discounts": "3.33", "current_total_discounts_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "current_total_duties_set": null, "current_total_price": "199.65", "current_total_price_set": { "shop_money": { "amount": "199.65", "currency_code": "USD" }, "presentment_money": { "amount": "199.65", "currency_code": "USD" } }, "current_total_tax": "3.98", "current_total_tax_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "customer_locale": null, "device_id": null, "discount_codes": [ { "code": "TENOFF", "amount": "10.00", "type": "fixed_amount" } ], "duties_included": false, "email": "bob.norman@mail.example.com", "estimated_taxes": false, "financial_status": "partially_refunded", "fulfillment_status": null, "landing_site": "http://www.example.com?source=abc", "landing_site_ref": "abc", "location_id": null, "merchant_business_entity_id": "MTU0ODM4MDAwOQ", "merchant_of_record_app_id": null, "name": "#1001", "note": null, "note_attributes": [ { "name": "custom engraving", "value": "Happy Birthday" }, { "name": "colour", "value": "green" } ], "number": 1, "order_number": 1001, "order_status_url": "https://jsmith.myshopify.com/548380009/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=imasecretipod", "original_total_additional_fees_set": null, "original_total_duties_set": null, "payment_gateway_names": [ "bogus" ], "phone": "+557734881234", "po_number": "ABC123", "presentment_currency": "USD", "processed_at": "2008-01-10T11:00:00-05:00", "reference": "fhwdgads", "referring_site": "http://www.otherexample.com", "source_identifier": "fhwdgads", "source_name": "web", "source_url": null, "subtotal_price": "597.00", "subtotal_price_set": { "shop_money": { "amount": "597.00", "currency_code": "USD" }, "presentment_money": { "amount": "597.00", "currency_code": "USD" } }, "tags": "", "tax_exempt": false, "tax_lines": [ { "price": "11.94", "rate": 0.06, "title": "State Tax", "price_set": { "shop_money": { "amount": "11.94", "currency_code": "USD" }, "presentment_money": { "amount": "11.94", "currency_code": "USD" } }, "channel_liable": null } ], "taxes_included": false, "test": false, "token": "b1946ac92492d2347c6235b4d2611184", "total_cash_rounding_payment_adjustment_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_cash_rounding_refund_adjustment_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_discounts": "10.00", "total_discounts_set": { "shop_money": { "amount": "10.00", "currency_code": "USD" }, "presentment_money": { "amount": "10.00", "currency_code": "USD" } }, "total_line_items_price": "597.00", "total_line_items_price_set": { "shop_money": { "amount": "597.00", "currency_code": "USD" }, "presentment_money": { "amount": "597.00", "currency_code": "USD" } }, "total_outstanding": "0.00", "total_price": "598.94", "total_price_set": { "shop_money": { "amount": "598.94", "currency_code": "USD" }, "presentment_money": { "amount": "598.94", "currency_code": "USD" } }, "total_shipping_price_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_tax": "11.94", "total_tax_set": { "shop_money": { "amount": "11.94", "currency_code": "USD" }, "presentment_money": { "amount": "11.94", "currency_code": "USD" } }, "total_tip_received": "0.00", "total_weight": 0, "updated_at": "2024-10-01T13:47:32-04:00", "user_id": null, "billing_address": { "first_name": "Bob", "address1": "Chestnut Street 92", "phone": "+1(502)-459-2181", "city": "Louisville", "zip": "40202", "province": "Kentucky", "country": "United States", "last_name": "Norman", "address2": "", "company": null, "latitude": 45.41634, "longitude": -75.6868, "name": "Bob Norman", "country_code": "US", "province_code": "KY" }, "customer": { "id": 207119551, "email": "bob.norman@mail.example.com", "created_at": "2024-10-01T13:46:05-04:00", "updated_at": "2024-10-01T13:46:05-04:00", "first_name": "Bob", "last_name": "Norman", "state": "disabled", "note": null, "verified_email": true, "multipass_identifier": null, "tax_exempt": false, "phone": "+16136120707", "email_marketing_consent": { "state": "not_subscribed", "opt_in_level": null, "consent_updated_at": "2004-06-13T11:57:11-04:00" }, "sms_marketing_consent": { "state": "not_subscribed", "opt_in_level": "single_opt_in", "consent_updated_at": "2024-10-01T13:46:05-04:00", "consent_collected_from": "OTHER" }, "tags": "Léon, Noël", "currency": "USD", "tax_exemptions": [], "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 } }, "discount_applications": [ { "target_type": "line_item", "type": "discount_code", "value": "10.0", "value_type": "fixed_amount", "allocation_method": "across", "target_selection": "all", "code": "TENOFF" } ], "fulfillments": [ { "id": 255858046, "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046", "created_at": "2024-10-01T13:46:05-04:00", "location_id": 655441491, "name": "#1001.0", "order_id": 450789469, "origin_address": {}, "receipt": { "testcase": true, "authorization": "123456" }, "service": "manual", "shipment_status": null, "status": "failure", "tracking_company": "USPS", "tracking_number": "1Z1234512345123456", "tracking_numbers": [ "1Z1234512345123456" ], "tracking_url": "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z1234512345123456", "tracking_urls": [ "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z1234512345123456" ], "updated_at": "2024-10-01T13:46:05-04:00", "line_items": [ { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] } ] } ], "line_items": [ { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] }, { "id": 518995019, "admin_graphql_api_id": "gid://shopify/LineItem/518995019", "attributed_staffs": [], "current_quantity": 1, "fulfillable_quantity": 1, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - red", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008RED", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 49148385, "variant_inventory_management": "shopify", "variant_title": "red", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] }, { "id": 703073504, "admin_graphql_api_id": "gid://shopify/LineItem/703073504", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - black", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008BLACK", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 457924702, "variant_inventory_management": "shopify", "variant_title": "black", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] } ], "payment_terms": null, "refunds": [ { "id": 509562969, "admin_graphql_api_id": "gid://shopify/Refund/509562969", "created_at": "2024-10-01T13:46:05-04:00", "note": "it broke during shipping", "order_id": 450789469, "processed_at": "2024-10-01T13:46:05-04:00", "restock": true, "total_additional_fees_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_duties_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "user_id": 548380009, "order_adjustments": [], "transactions": [ { "id": 179259969, "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969", "amount": "209.00", "authorization": "authorization-key", "created_at": "2005-08-05T12:59:12-04:00", "currency": "USD", "device_id": null, "error_code": null, "gateway": "bogus", "kind": "refund", "location_id": null, "message": null, "order_id": 450789469, "parent_id": 801038806, "payment_id": "#1001.3", "processed_at": "2005-08-05T12:59:12-04:00", "receipt": {}, "source_name": "web", "status": "success", "test": false, "user_id": null } ], "refund_line_items": [ { "id": 104689539, "line_item_id": 703073504, "location_id": 487838322, "quantity": 1, "restock_type": "legacy_restock", "subtotal": 195.66, "subtotal_set": { "shop_money": { "amount": "195.66", "currency_code": "USD" }, "presentment_money": { "amount": "195.66", "currency_code": "USD" } }, "total_tax": 3.98, "total_tax_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "line_item": { "id": 703073504, "admin_graphql_api_id": "gid://shopify/LineItem/703073504", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - black", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008BLACK", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 457924702, "variant_inventory_management": "shopify", "variant_title": "black", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] } }, { "id": 709875399, "line_item_id": 466157049, "location_id": 487838322, "quantity": 1, "restock_type": "legacy_restock", "subtotal": 195.67, "subtotal_set": { "shop_money": { "amount": "195.67", "currency_code": "USD" }, "presentment_money": { "amount": "195.67", "currency_code": "USD" } }, "total_tax": 3.98, "total_tax_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "line_item": { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] } } ], "duties": [], "additional_fees": [] } ], "shipping_address": { "first_name": "Bob", "address1": "Chestnut Street 92", "phone": "+1(502)-459-2181", "city": "Louisville", "zip": "40202", "province": "Kentucky", "country": "United States", "last_name": "Norman", "address2": "", "company": null, "latitude": 45.41634, "longitude": -75.6868, "name": "Bob Norman", "country_code": "US", "province_code": "KY" }, "shipping_lines": [ { "id": 369256396, "carrier_identifier": null, "code": "Free Shipping", "discounted_price": "0.00", "discounted_price_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "is_removed": false, "phone": null, "price": "0.00", "price_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "requested_fulfillment_service_id": null, "source": "shopify", "title": "Free Shipping", "tax_lines": [], "discount_allocations": [] } ] }, "notice": "Order has been canceled" }
postClose an order
orders
access scope.
curl -d '{}' \ -X POST "https://your-development-store.myshopify.com/admin/api/2024-10/orders/450789469/close.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json"
HTTP/1.1 200 OK { "order": { "id": 450789469, "admin_graphql_api_id": "gid://shopify/Order/450789469", "app_id": null, "browser_ip": "0.0.0.0", "buyer_accepts_marketing": false, "cancel_reason": null, "cancelled_at": null, "cart_token": "68778783ad298f1c80c3bafcddeea02f", "checkout_id": 901414060, "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c", "client_details": { "accept_language": null, "browser_height": null, "browser_ip": "0.0.0.0", "browser_width": null, "session_hash": null, "user_agent": null }, "closed_at": "2024-10-01T13:47:38-04:00", "confirmation_number": null, "confirmed": true, "contact_email": "bob.norman@mail.example.com", "created_at": "2008-01-10T11:00:00-05:00", "currency": "USD", "current_subtotal_price": "195.67", "current_subtotal_price_set": { "shop_money": { "amount": "195.67", "currency_code": "USD" }, "presentment_money": { "amount": "195.67", "currency_code": "USD" } }, "current_total_additional_fees_set": null, "current_total_discounts": "3.33", "current_total_discounts_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "current_total_duties_set": null, "current_total_price": "199.65", "current_total_price_set": { "shop_money": { "amount": "199.65", "currency_code": "USD" }, "presentment_money": { "amount": "199.65", "currency_code": "USD" } }, "current_total_tax": "3.98", "current_total_tax_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "customer_locale": null, "device_id": null, "discount_codes": [ { "code": "TENOFF", "amount": "10.00", "type": "fixed_amount" } ], "duties_included": false, "email": "bob.norman@mail.example.com", "estimated_taxes": false, "financial_status": "partially_refunded", "fulfillment_status": null, "landing_site": "http://www.example.com?source=abc", "landing_site_ref": "abc", "location_id": null, "merchant_business_entity_id": "MTU0ODM4MDAwOQ", "merchant_of_record_app_id": null, "name": "#1001", "note": null, "note_attributes": [ { "name": "custom engraving", "value": "Happy Birthday" }, { "name": "colour", "value": "green" } ], "number": 1, "order_number": 1001, "order_status_url": "https://jsmith.myshopify.com/548380009/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=imasecretipod", "original_total_additional_fees_set": null, "original_total_duties_set": null, "payment_gateway_names": [ "bogus" ], "phone": "+557734881234", "po_number": "ABC123", "presentment_currency": "USD", "processed_at": "2008-01-10T11:00:00-05:00", "reference": "fhwdgads", "referring_site": "http://www.otherexample.com", "source_identifier": "fhwdgads", "source_name": "web", "source_url": null, "subtotal_price": "597.00", "subtotal_price_set": { "shop_money": { "amount": "597.00", "currency_code": "USD" }, "presentment_money": { "amount": "597.00", "currency_code": "USD" } }, "tags": "", "tax_exempt": false, "tax_lines": [ { "price": "11.94", "rate": 0.06, "title": "State Tax", "price_set": { "shop_money": { "amount": "11.94", "currency_code": "USD" }, "presentment_money": { "amount": "11.94", "currency_code": "USD" } }, "channel_liable": null } ], "taxes_included": false, "test": false, "token": "b1946ac92492d2347c6235b4d2611184", "total_cash_rounding_payment_adjustment_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_cash_rounding_refund_adjustment_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_discounts": "10.00", "total_discounts_set": { "shop_money": { "amount": "10.00", "currency_code": "USD" }, "presentment_money": { "amount": "10.00", "currency_code": "USD" } }, "total_line_items_price": "597.00", "total_line_items_price_set": { "shop_money": { "amount": "597.00", "currency_code": "USD" }, "presentment_money": { "amount": "597.00", "currency_code": "USD" } }, "total_outstanding": "0.00", "total_price": "598.94", "total_price_set": { "shop_money": { "amount": "598.94", "currency_code": "USD" }, "presentment_money": { "amount": "598.94", "currency_code": "USD" } }, "total_shipping_price_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_tax": "11.94", "total_tax_set": { "shop_money": { "amount": "11.94", "currency_code": "USD" }, "presentment_money": { "amount": "11.94", "currency_code": "USD" } }, "total_tip_received": "0.00", "total_weight": 0, "updated_at": "2024-10-01T13:47:38-04:00", "user_id": null, "billing_address": { "first_name": "Bob", "address1": "Chestnut Street 92", "phone": "+1(502)-459-2181", "city": "Louisville", "zip": "40202", "province": "Kentucky", "country": "United States", "last_name": "Norman", "address2": "", "company": null, "latitude": 45.41634, "longitude": -75.6868, "name": "Bob Norman", "country_code": "US", "province_code": "KY" }, "customer": { "id": 207119551, "email": "bob.norman@mail.example.com", "created_at": "2024-10-01T13:46:05-04:00", "updated_at": "2024-10-01T13:46:05-04:00", "first_name": "Bob", "last_name": "Norman", "state": "disabled", "note": null, "verified_email": true, "multipass_identifier": null, "tax_exempt": false, "phone": "+16136120707", "email_marketing_consent": { "state": "not_subscribed", "opt_in_level": null, "consent_updated_at": "2004-06-13T11:57:11-04:00" }, "sms_marketing_consent": { "state": "not_subscribed", "opt_in_level": "single_opt_in", "consent_updated_at": "2024-10-01T13:46:05-04:00", "consent_collected_from": "OTHER" }, "tags": "Léon, Noël", "currency": "USD", "tax_exemptions": [], "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 } }, "discount_applications": [ { "target_type": "line_item", "type": "discount_code", "value": "10.0", "value_type": "fixed_amount", "allocation_method": "across", "target_selection": "all", "code": "TENOFF" } ], "fulfillments": [ { "id": 255858046, "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046", "created_at": "2024-10-01T13:46:05-04:00", "location_id": 655441491, "name": "#1001.0", "order_id": 450789469, "origin_address": {}, "receipt": { "testcase": true, "authorization": "123456" }, "service": "manual", "shipment_status": null, "status": "failure", "tracking_company": "USPS", "tracking_number": "1Z1234512345123456", "tracking_numbers": [ "1Z1234512345123456" ], "tracking_url": "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z1234512345123456", "tracking_urls": [ "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z1234512345123456" ], "updated_at": "2024-10-01T13:46:05-04:00", "line_items": [ { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] } ] } ], "line_items": [ { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] }, { "id": 518995019, "admin_graphql_api_id": "gid://shopify/LineItem/518995019", "attributed_staffs": [], "current_quantity": 1, "fulfillable_quantity": 1, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - red", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008RED", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 49148385, "variant_inventory_management": "shopify", "variant_title": "red", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] }, { "id": 703073504, "admin_graphql_api_id": "gid://shopify/LineItem/703073504", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - black", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008BLACK", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 457924702, "variant_inventory_management": "shopify", "variant_title": "black", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] } ], "payment_terms": null, "refunds": [ { "id": 509562969, "admin_graphql_api_id": "gid://shopify/Refund/509562969", "created_at": "2024-10-01T13:46:05-04:00", "note": "it broke during shipping", "order_id": 450789469, "processed_at": "2024-10-01T13:46:05-04:00", "restock": true, "total_additional_fees_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_duties_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "user_id": 548380009, "order_adjustments": [], "transactions": [ { "id": 179259969, "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969", "amount": "209.00", "authorization": "authorization-key", "created_at": "2005-08-05T12:59:12-04:00", "currency": "USD", "device_id": null, "error_code": null, "gateway": "bogus", "kind": "refund", "location_id": null, "message": null, "order_id": 450789469, "parent_id": 801038806, "payment_id": "#1001.3", "processed_at": "2005-08-05T12:59:12-04:00", "receipt": {}, "source_name": "web", "status": "success", "test": false, "user_id": null } ], "refund_line_items": [ { "id": 104689539, "line_item_id": 703073504, "location_id": 487838322, "quantity": 1, "restock_type": "legacy_restock", "subtotal": 195.66, "subtotal_set": { "shop_money": { "amount": "195.66", "currency_code": "USD" }, "presentment_money": { "amount": "195.66", "currency_code": "USD" } }, "total_tax": 3.98, "total_tax_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "line_item": { "id": 703073504, "admin_graphql_api_id": "gid://shopify/LineItem/703073504", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - black", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008BLACK", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 457924702, "variant_inventory_management": "shopify", "variant_title": "black", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] } }, { "id": 709875399, "line_item_id": 466157049, "location_id": 487838322, "quantity": 1, "restock_type": "legacy_restock", "subtotal": 195.67, "subtotal_set": { "shop_money": { "amount": "195.67", "currency_code": "USD" }, "presentment_money": { "amount": "195.67", "currency_code": "USD" } }, "total_tax": 3.98, "total_tax_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "line_item": { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] } } ], "duties": [], "additional_fees": [] } ], "shipping_address": { "first_name": "Bob", "address1": "Chestnut Street 92", "phone": "+1(502)-459-2181", "city": "Louisville", "zip": "40202", "province": "Kentucky", "country": "United States", "last_name": "Norman", "address2": "", "company": null, "latitude": 45.41634, "longitude": -75.6868, "name": "Bob Norman", "country_code": "US", "province_code": "KY" }, "shipping_lines": [ { "id": 369256396, "carrier_identifier": null, "code": "Free Shipping", "discounted_price": "0.00", "discounted_price_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "is_removed": false, "phone": null, "price": "0.00", "price_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "requested_fulfillment_service_id": null, "source": "shopify", "title": "Free Shipping", "tax_lines": [], "discount_allocations": [] } ] } }
postRe-open a closed order
orders
access scope.
curl -d '{}' \ -X POST "https://your-development-store.myshopify.com/admin/api/2024-10/orders/450789469/open.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json"
HTTP/1.1 200 OK { "order": { "id": 450789469, "admin_graphql_api_id": "gid://shopify/Order/450789469", "app_id": null, "browser_ip": "0.0.0.0", "buyer_accepts_marketing": false, "cancel_reason": null, "cancelled_at": null, "cart_token": "68778783ad298f1c80c3bafcddeea02f", "checkout_id": 901414060, "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c", "client_details": { "accept_language": null, "browser_height": null, "browser_ip": "0.0.0.0", "browser_width": null, "session_hash": null, "user_agent": null }, "closed_at": null, "confirmation_number": null, "confirmed": true, "contact_email": "bob.norman@mail.example.com", "created_at": "2008-01-10T11:00:00-05:00", "currency": "USD", "current_subtotal_price": "195.67", "current_subtotal_price_set": { "shop_money": { "amount": "195.67", "currency_code": "USD" }, "presentment_money": { "amount": "195.67", "currency_code": "USD" } }, "current_total_additional_fees_set": null, "current_total_discounts": "3.33", "current_total_discounts_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "current_total_duties_set": null, "current_total_price": "199.65", "current_total_price_set": { "shop_money": { "amount": "199.65", "currency_code": "USD" }, "presentment_money": { "amount": "199.65", "currency_code": "USD" } }, "current_total_tax": "3.98", "current_total_tax_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "customer_locale": null, "device_id": null, "discount_codes": [ { "code": "TENOFF", "amount": "10.00", "type": "fixed_amount" } ], "duties_included": false, "email": "bob.norman@mail.example.com", "estimated_taxes": false, "financial_status": "partially_refunded", "fulfillment_status": null, "landing_site": "http://www.example.com?source=abc", "landing_site_ref": "abc", "location_id": null, "merchant_business_entity_id": "MTU0ODM4MDAwOQ", "merchant_of_record_app_id": null, "name": "#1001", "note": null, "note_attributes": [ { "name": "custom engraving", "value": "Happy Birthday" }, { "name": "colour", "value": "green" } ], "number": 1, "order_number": 1001, "order_status_url": "https://jsmith.myshopify.com/548380009/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=imasecretipod", "original_total_additional_fees_set": null, "original_total_duties_set": null, "payment_gateway_names": [ "bogus" ], "phone": "+557734881234", "po_number": "ABC123", "presentment_currency": "USD", "processed_at": "2008-01-10T11:00:00-05:00", "reference": "fhwdgads", "referring_site": "http://www.otherexample.com", "source_identifier": "fhwdgads", "source_name": "web", "source_url": null, "subtotal_price": "597.00", "subtotal_price_set": { "shop_money": { "amount": "597.00", "currency_code": "USD" }, "presentment_money": { "amount": "597.00", "currency_code": "USD" } }, "tags": "", "tax_exempt": false, "tax_lines": [ { "price": "11.94", "rate": 0.06, "title": "State Tax", "price_set": { "shop_money": { "amount": "11.94", "currency_code": "USD" }, "presentment_money": { "amount": "11.94", "currency_code": "USD" } }, "channel_liable": null } ], "taxes_included": false, "test": false, "token": "b1946ac92492d2347c6235b4d2611184", "total_cash_rounding_payment_adjustment_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_cash_rounding_refund_adjustment_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_discounts": "10.00", "total_discounts_set": { "shop_money": { "amount": "10.00", "currency_code": "USD" }, "presentment_money": { "amount": "10.00", "currency_code": "USD" } }, "total_line_items_price": "597.00", "total_line_items_price_set": { "shop_money": { "amount": "597.00", "currency_code": "USD" }, "presentment_money": { "amount": "597.00", "currency_code": "USD" } }, "total_outstanding": "0.00", "total_price": "598.94", "total_price_set": { "shop_money": { "amount": "598.94", "currency_code": "USD" }, "presentment_money": { "amount": "598.94", "currency_code": "USD" } }, "total_shipping_price_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_tax": "11.94", "total_tax_set": { "shop_money": { "amount": "11.94", "currency_code": "USD" }, "presentment_money": { "amount": "11.94", "currency_code": "USD" } }, "total_tip_received": "0.00", "total_weight": 0, "updated_at": "2024-10-01T13:46:16-04:00", "user_id": null, "billing_address": { "first_name": "Bob", "address1": "Chestnut Street 92", "phone": "+1(502)-459-2181", "city": "Louisville", "zip": "40202", "province": "Kentucky", "country": "United States", "last_name": "Norman", "address2": "", "company": null, "latitude": 45.41634, "longitude": -75.6868, "name": "Bob Norman", "country_code": "US", "province_code": "KY" }, "customer": { "id": 207119551, "email": "bob.norman@mail.example.com", "created_at": "2024-10-01T13:46:05-04:00", "updated_at": "2024-10-01T13:46:05-04:00", "first_name": "Bob", "last_name": "Norman", "state": "disabled", "note": null, "verified_email": true, "multipass_identifier": null, "tax_exempt": false, "phone": "+16136120707", "email_marketing_consent": { "state": "not_subscribed", "opt_in_level": null, "consent_updated_at": "2004-06-13T11:57:11-04:00" }, "sms_marketing_consent": { "state": "not_subscribed", "opt_in_level": "single_opt_in", "consent_updated_at": "2024-10-01T13:46:05-04:00", "consent_collected_from": "OTHER" }, "tags": "Léon, Noël", "currency": "USD", "tax_exemptions": [], "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 } }, "discount_applications": [ { "target_type": "line_item", "type": "discount_code", "value": "10.0", "value_type": "fixed_amount", "allocation_method": "across", "target_selection": "all", "code": "TENOFF" } ], "fulfillments": [ { "id": 255858046, "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046", "created_at": "2024-10-01T13:46:05-04:00", "location_id": 655441491, "name": "#1001.0", "order_id": 450789469, "origin_address": {}, "receipt": { "testcase": true, "authorization": "123456" }, "service": "manual", "shipment_status": null, "status": "failure", "tracking_company": "USPS", "tracking_number": "1Z1234512345123456", "tracking_numbers": [ "1Z1234512345123456" ], "tracking_url": "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z1234512345123456", "tracking_urls": [ "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z1234512345123456" ], "updated_at": "2024-10-01T13:46:05-04:00", "line_items": [ { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] } ] } ], "line_items": [ { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] }, { "id": 518995019, "admin_graphql_api_id": "gid://shopify/LineItem/518995019", "attributed_staffs": [], "current_quantity": 1, "fulfillable_quantity": 1, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - red", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008RED", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 49148385, "variant_inventory_management": "shopify", "variant_title": "red", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] }, { "id": 703073504, "admin_graphql_api_id": "gid://shopify/LineItem/703073504", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - black", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008BLACK", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 457924702, "variant_inventory_management": "shopify", "variant_title": "black", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] } ], "payment_terms": null, "refunds": [ { "id": 509562969, "admin_graphql_api_id": "gid://shopify/Refund/509562969", "created_at": "2024-10-01T13:46:05-04:00", "note": "it broke during shipping", "order_id": 450789469, "processed_at": "2024-10-01T13:46:05-04:00", "restock": true, "total_additional_fees_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_duties_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "user_id": 548380009, "order_adjustments": [], "transactions": [ { "id": 179259969, "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969", "amount": "209.00", "authorization": "authorization-key", "created_at": "2005-08-05T12:59:12-04:00", "currency": "USD", "device_id": null, "error_code": null, "gateway": "bogus", "kind": "refund", "location_id": null, "message": null, "order_id": 450789469, "parent_id": 801038806, "payment_id": "#1001.3", "processed_at": "2005-08-05T12:59:12-04:00", "receipt": {}, "source_name": "web", "status": "success", "test": false, "user_id": null } ], "refund_line_items": [ { "id": 104689539, "line_item_id": 703073504, "location_id": 487838322, "quantity": 1, "restock_type": "legacy_restock", "subtotal": 195.66, "subtotal_set": { "shop_money": { "amount": "195.66", "currency_code": "USD" }, "presentment_money": { "amount": "195.66", "currency_code": "USD" } }, "total_tax": 3.98, "total_tax_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "line_item": { "id": 703073504, "admin_graphql_api_id": "gid://shopify/LineItem/703073504", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - black", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008BLACK", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 457924702, "variant_inventory_management": "shopify", "variant_title": "black", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] } }, { "id": 709875399, "line_item_id": 466157049, "location_id": 487838322, "quantity": 1, "restock_type": "legacy_restock", "subtotal": 195.67, "subtotal_set": { "shop_money": { "amount": "195.67", "currency_code": "USD" }, "presentment_money": { "amount": "195.67", "currency_code": "USD" } }, "total_tax": 3.98, "total_tax_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "line_item": { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] } } ], "duties": [], "additional_fees": [] } ], "shipping_address": { "first_name": "Bob", "address1": "Chestnut Street 92", "phone": "+1(502)-459-2181", "city": "Louisville", "zip": "40202", "province": "Kentucky", "country": "United States", "last_name": "Norman", "address2": "", "company": null, "latitude": 45.41634, "longitude": -75.6868, "name": "Bob Norman", "country_code": "US", "province_code": "KY" }, "shipping_lines": [ { "id": 369256396, "carrier_identifier": null, "code": "Free Shipping", "discounted_price": "0.00", "discounted_price_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "is_removed": false, "phone": null, "price": "0.00", "price_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "requested_fulfillment_service_id": null, "source": "shopify", "title": "Free Shipping", "tax_lines": [], "discount_allocations": [] } ] } }
getRetrieve a list of orders
orders
, marketplace_orders
.
current
to show orders for the app currently consuming the API.curl -X GET "https://your-development-store.myshopify.com/admin/api/2024-10/orders.json?status=any" \ -H "X-Shopify-Access-Token: {access_token}"
HTTP/1.1 200 OK { "orders": [ { "id": 450789469, "admin_graphql_api_id": "gid://shopify/Order/450789469", "app_id": null, "browser_ip": "0.0.0.0", "buyer_accepts_marketing": false, "cancel_reason": null, "cancelled_at": null, "cart_token": "68778783ad298f1c80c3bafcddeea02f", "checkout_id": 901414060, "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c", "client_details": { "accept_language": null, "browser_height": null, "browser_ip": "0.0.0.0", "browser_width": null, "session_hash": null, "user_agent": null }, "closed_at": null, "confirmation_number": null, "confirmed": true, "contact_email": "bob.norman@mail.example.com", "created_at": "2008-01-10T11:00:00-05:00", "currency": "USD", "current_subtotal_price": "195.67", "current_subtotal_price_set": { "shop_money": { "amount": "195.67", "currency_code": "USD" }, "presentment_money": { "amount": "195.67", "currency_code": "USD" } }, "current_total_additional_fees_set": null, "current_total_discounts": "3.33", "current_total_discounts_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "current_total_duties_set": null, "current_total_price": "199.65", "current_total_price_set": { "shop_money": { "amount": "199.65", "currency_code": "USD" }, "presentment_money": { "amount": "199.65", "currency_code": "USD" } }, "current_total_tax": "3.98", "current_total_tax_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "customer_locale": null, "device_id": null, "discount_codes": [ { "code": "TENOFF", "amount": "10.00", "type": "fixed_amount" } ], "duties_included": false, "email": "bob.norman@mail.example.com", "estimated_taxes": false, "financial_status": "partially_refunded", "fulfillment_status": null, "landing_site": "http://www.example.com?source=abc", "landing_site_ref": "abc", "location_id": null, "merchant_business_entity_id": "MTU0ODM4MDAwOQ", "merchant_of_record_app_id": null, "name": "#1001", "note": null, "note_attributes": [ { "name": "custom engraving", "value": "Happy Birthday" }, { "name": "colour", "value": "green" } ], "number": 1, "order_number": 1001, "order_status_url": "https://jsmith.myshopify.com/548380009/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=imasecretipod", "original_total_additional_fees_set": null, "original_total_duties_set": null, "payment_gateway_names": [ "bogus" ], "phone": "+557734881234", "po_number": "ABC123", "presentment_currency": "USD", "processed_at": "2008-01-10T11:00:00-05:00", "reference": "fhwdgads", "referring_site": "http://www.otherexample.com", "source_identifier": "fhwdgads", "source_name": "web", "source_url": null, "subtotal_price": "597.00", "subtotal_price_set": { "shop_money": { "amount": "597.00", "currency_code": "USD" }, "presentment_money": { "amount": "597.00", "currency_code": "USD" } }, "tags": "", "tax_exempt": false, "tax_lines": [ { "price": "11.94", "rate": 0.06, "title": "State Tax", "price_set": { "shop_money": { "amount": "11.94", "currency_code": "USD" }, "presentment_money": { "amount": "11.94", "currency_code": "USD" } }, "channel_liable": null } ], "taxes_included": false, "test": false, "token": "b1946ac92492d2347c6235b4d2611184", "total_cash_rounding_payment_adjustment_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_cash_rounding_refund_adjustment_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_discounts": "10.00", "total_discounts_set": { "shop_money": { "amount": "10.00", "currency_code": "USD" }, "presentment_money": { "amount": "10.00", "currency_code": "USD" } }, "total_line_items_price": "597.00", "total_line_items_price_set": { "shop_money": { "amount": "597.00", "currency_code": "USD" }, "presentment_money": { "amount": "597.00", "currency_code": "USD" } }, "total_outstanding": "0.00", "total_price": "598.94", "total_price_set": { "shop_money": { "amount": "598.94", "currency_code": "USD" }, "presentment_money": { "amount": "598.94", "currency_code": "USD" } }, "total_shipping_price_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_tax": "11.94", "total_tax_set": { "shop_money": { "amount": "11.94", "currency_code": "USD" }, "presentment_money": { "amount": "11.94", "currency_code": "USD" } }, "total_tip_received": "0.00", "total_weight": 0, "updated_at": "2008-01-10T11:00:00-05:00", "user_id": null, "billing_address": { "first_name": "Bob", "address1": "Chestnut Street 92", "phone": "+1(502)-459-2181", "city": "Louisville", "zip": "40202", "province": "Kentucky", "country": "United States", "last_name": "Norman", "address2": "", "company": null, "latitude": 45.41634, "longitude": -75.6868, "name": "Bob Norman", "country_code": "US", "province_code": "KY" }, "customer": { "id": 207119551, "email": "bob.norman@mail.example.com", "created_at": "2024-10-01T13:46:05-04:00", "updated_at": "2024-10-01T13:46:05-04:00", "first_name": "Bob", "last_name": "Norman", "state": "disabled", "note": null, "verified_email": true, "multipass_identifier": null, "tax_exempt": false, "phone": "+16136120707", "email_marketing_consent": { "state": "not_subscribed", "opt_in_level": null, "consent_updated_at": "2004-06-13T11:57:11-04:00" }, "sms_marketing_consent": { "state": "not_subscribed", "opt_in_level": "single_opt_in", "consent_updated_at": "2024-10-01T13:46:05-04:00", "consent_collected_from": "OTHER" }, "tags": "Léon, Noël", "currency": "USD", "tax_exemptions": [], "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 } }, "discount_applications": [ { "target_type": "line_item", "type": "discount_code", "value": "10.0", "value_type": "fixed_amount", "allocation_method": "across", "target_selection": "all", "code": "TENOFF" } ], "fulfillments": [ { "id": 255858046, "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046", "created_at": "2024-10-01T13:46:05-04:00", "location_id": 655441491, "name": "#1001.0", "order_id": 450789469, "origin_address": {}, "receipt": { "testcase": true, "authorization": "123456" }, "service": "manual", "shipment_status": null, "status": "failure", "tracking_company": "USPS", "tracking_number": "1Z1234512345123456", "tracking_numbers": [ "1Z1234512345123456" ], "tracking_url": "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z1234512345123456", "tracking_urls": [ "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z1234512345123456" ], "updated_at": "2024-10-01T13:46:05-04:00", "line_items": [ { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] } ] } ], "line_items": [ { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] }, { "id": 518995019, "admin_graphql_api_id": "gid://shopify/LineItem/518995019", "attributed_staffs": [], "current_quantity": 1, "fulfillable_quantity": 1, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - red", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008RED", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 49148385, "variant_inventory_management": "shopify", "variant_title": "red", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] }, { "id": 703073504, "admin_graphql_api_id": "gid://shopify/LineItem/703073504", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - black", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008BLACK", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 457924702, "variant_inventory_management": "shopify", "variant_title": "black", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] } ], "payment_terms": null, "refunds": [ { "id": 509562969, "admin_graphql_api_id": "gid://shopify/Refund/509562969", "created_at": "2024-10-01T13:46:05-04:00", "note": "it broke during shipping", "order_id": 450789469, "processed_at": "2024-10-01T13:46:05-04:00", "restock": true, "total_additional_fees_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_duties_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "user_id": 548380009, "order_adjustments": [], "transactions": [ { "id": 179259969, "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969", "amount": "209.00", "authorization": "authorization-key", "created_at": "2005-08-05T12:59:12-04:00", "currency": "USD", "device_id": null, "error_code": null, "gateway": "bogus", "kind": "refund", "location_id": null, "message": null, "order_id": 450789469, "parent_id": 801038806, "payment_id": "#1001.3", "processed_at": "2005-08-05T12:59:12-04:00", "receipt": {}, "source_name": "web", "status": "success", "test": false, "user_id": null } ], "refund_line_items": [ { "id": 104689539, "line_item_id": 703073504, "location_id": 487838322, "quantity": 1, "restock_type": "legacy_restock", "subtotal": 195.66, "subtotal_set": { "shop_money": { "amount": "195.66", "currency_code": "USD" }, "presentment_money": { "amount": "195.66", "currency_code": "USD" } }, "total_tax": 3.98, "total_tax_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "line_item": { "id": 703073504, "admin_graphql_api_id": "gid://shopify/LineItem/703073504", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - black", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008BLACK", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 457924702, "variant_inventory_management": "shopify", "variant_title": "black", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] } }, { "id": 709875399, "line_item_id": 466157049, "location_id": 487838322, "quantity": 1, "restock_type": "legacy_restock", "subtotal": 195.67, "subtotal_set": { "shop_money": { "amount": "195.67", "currency_code": "USD" }, "presentment_money": { "amount": "195.67", "currency_code": "USD" } }, "total_tax": 3.98, "total_tax_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "line_item": { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] } } ], "duties": [], "additional_fees": [] } ], "shipping_address": { "first_name": "Bob", "address1": "Chestnut Street 92", "phone": "+1(502)-459-2181", "city": "Louisville", "zip": "40202", "province": "Kentucky", "country": "United States", "last_name": "Norman", "address2": "", "company": null, "latitude": 45.41634, "longitude": -75.6868, "name": "Bob Norman", "country_code": "US", "province_code": "KY" }, "shipping_lines": [ { "id": 369256396, "carrier_identifier": null, "code": "Free Shipping", "discounted_price": "0.00", "discounted_price_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "is_removed": false, "phone": null, "price": "0.00", "price_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "requested_fulfillment_service_id": null, "source": "shopify", "title": "Free Shipping", "tax_lines": [], "discount_allocations": [] } ] } ] }
getRetrieve a specific order
orders
, marketplace_orders
.
curl -X GET "https://your-development-store.myshopify.com/admin/api/2024-10/orders/450789469.json?fields=id%2Cline_items%2Cname%2Ctotal_price" \ -H "X-Shopify-Access-Token: {access_token}"
HTTP/1.1 200 OK { "order": { "id": 450789469, "name": "#1001", "total_price": "598.94", "line_items": [ { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] }, { "id": 518995019, "admin_graphql_api_id": "gid://shopify/LineItem/518995019", "current_quantity": 1, "fulfillable_quantity": 1, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - red", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008RED", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 49148385, "variant_inventory_management": "shopify", "variant_title": "red", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] }, { "id": 703073504, "admin_graphql_api_id": "gid://shopify/LineItem/703073504", "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - black", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008BLACK", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 457924702, "variant_inventory_management": "shopify", "variant_title": "black", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] } ] } }
getRetrieve an order count
orders
access scope.
curl -X GET "https://your-development-store.myshopify.com/admin/api/2024-10/orders/count.json?status=any" \ -H "X-Shopify-Access-Token: {access_token}"
HTTP/1.1 200 OK { "count": 1 }
putUpdate an order
orders
, marketplace_orders
.
This operation allows for updating properties of an order including buyer_accepts_marketing
,
email
, phone
, note
, tags
, metafields
and shipping_address_attributes
.
It is not for editing the items of an order.
curl -d '{"order":{"id":450789469,"metafields":[{"key":"new","value":"newvalue","type":"single_line_text_field","namespace":"global"}]}}' \ -X PUT "https://your-development-store.myshopify.com/admin/api/2024-10/orders/450789469.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json"
HTTP/1.1 200 OK { "order": { "id": 450789469, "admin_graphql_api_id": "gid://shopify/Order/450789469", "app_id": null, "browser_ip": "0.0.0.0", "buyer_accepts_marketing": false, "cancel_reason": null, "cancelled_at": null, "cart_token": "68778783ad298f1c80c3bafcddeea02f", "checkout_id": 901414060, "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c", "client_details": { "accept_language": null, "browser_height": null, "browser_ip": "0.0.0.0", "browser_width": null, "session_hash": null, "user_agent": null }, "closed_at": null, "confirmation_number": null, "confirmed": true, "contact_email": "bob.norman@mail.example.com", "created_at": "2008-01-10T11:00:00-05:00", "currency": "USD", "current_subtotal_price": "195.67", "current_subtotal_price_set": { "shop_money": { "amount": "195.67", "currency_code": "USD" }, "presentment_money": { "amount": "195.67", "currency_code": "USD" } }, "current_total_additional_fees_set": null, "current_total_discounts": "3.33", "current_total_discounts_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "current_total_duties_set": null, "current_total_price": "199.65", "current_total_price_set": { "shop_money": { "amount": "199.65", "currency_code": "USD" }, "presentment_money": { "amount": "199.65", "currency_code": "USD" } }, "current_total_tax": "3.98", "current_total_tax_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "customer_locale": null, "device_id": null, "discount_codes": [ { "code": "TENOFF", "amount": "10.00", "type": "fixed_amount" } ], "duties_included": false, "email": "bob.norman@mail.example.com", "estimated_taxes": false, "financial_status": "partially_refunded", "fulfillment_status": null, "landing_site": "http://www.example.com?source=abc", "landing_site_ref": "abc", "location_id": null, "merchant_business_entity_id": "MTU0ODM4MDAwOQ", "merchant_of_record_app_id": null, "name": "#1001", "note": null, "note_attributes": [ { "name": "custom engraving", "value": "Happy Birthday" }, { "name": "colour", "value": "green" } ], "number": 1, "order_number": 1001, "order_status_url": "https://jsmith.myshopify.com/548380009/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=imasecretipod", "original_total_additional_fees_set": null, "original_total_duties_set": null, "payment_gateway_names": [ "bogus" ], "phone": "+557734881234", "po_number": "ABC123", "presentment_currency": "USD", "processed_at": "2008-01-10T11:00:00-05:00", "reference": "fhwdgads", "referring_site": "http://www.otherexample.com", "source_identifier": "fhwdgads", "source_name": "web", "source_url": null, "subtotal_price": "597.00", "subtotal_price_set": { "shop_money": { "amount": "597.00", "currency_code": "USD" }, "presentment_money": { "amount": "597.00", "currency_code": "USD" } }, "tags": "", "tax_exempt": false, "tax_lines": [ { "price": "11.94", "rate": 0.06, "title": "State Tax", "price_set": { "shop_money": { "amount": "11.94", "currency_code": "USD" }, "presentment_money": { "amount": "11.94", "currency_code": "USD" } }, "channel_liable": null } ], "taxes_included": false, "test": false, "token": "b1946ac92492d2347c6235b4d2611184", "total_cash_rounding_payment_adjustment_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_cash_rounding_refund_adjustment_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_discounts": "10.00", "total_discounts_set": { "shop_money": { "amount": "10.00", "currency_code": "USD" }, "presentment_money": { "amount": "10.00", "currency_code": "USD" } }, "total_line_items_price": "597.00", "total_line_items_price_set": { "shop_money": { "amount": "597.00", "currency_code": "USD" }, "presentment_money": { "amount": "597.00", "currency_code": "USD" } }, "total_outstanding": "0.00", "total_price": "598.94", "total_price_set": { "shop_money": { "amount": "598.94", "currency_code": "USD" }, "presentment_money": { "amount": "598.94", "currency_code": "USD" } }, "total_shipping_price_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_tax": "11.94", "total_tax_set": { "shop_money": { "amount": "11.94", "currency_code": "USD" }, "presentment_money": { "amount": "11.94", "currency_code": "USD" } }, "total_tip_received": "0.00", "total_weight": 0, "updated_at": "2024-10-01T13:46:39-04:00", "user_id": null, "billing_address": { "first_name": "Bob", "address1": "Chestnut Street 92", "phone": "+1(502)-459-2181", "city": "Louisville", "zip": "40202", "province": "Kentucky", "country": "United States", "last_name": "Norman", "address2": "", "company": null, "latitude": 45.41634, "longitude": -75.6868, "name": "Bob Norman", "country_code": "US", "province_code": "KY" }, "customer": { "id": 207119551, "email": "bob.norman@mail.example.com", "created_at": "2024-10-01T13:46:05-04:00", "updated_at": "2024-10-01T13:46:05-04:00", "first_name": "Bob", "last_name": "Norman", "state": "disabled", "note": null, "verified_email": true, "multipass_identifier": null, "tax_exempt": false, "phone": "+16136120707", "email_marketing_consent": { "state": "not_subscribed", "opt_in_level": null, "consent_updated_at": "2004-06-13T11:57:11-04:00" }, "sms_marketing_consent": { "state": "not_subscribed", "opt_in_level": "single_opt_in", "consent_updated_at": "2024-10-01T13:46:05-04:00", "consent_collected_from": "OTHER" }, "tags": "Léon, Noël", "currency": "USD", "tax_exemptions": [], "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 } }, "discount_applications": [ { "target_type": "line_item", "type": "discount_code", "value": "10.0", "value_type": "fixed_amount", "allocation_method": "across", "target_selection": "all", "code": "TENOFF" } ], "fulfillments": [ { "id": 255858046, "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046", "created_at": "2024-10-01T13:46:05-04:00", "location_id": 655441491, "name": "#1001.0", "order_id": 450789469, "origin_address": {}, "receipt": { "testcase": true, "authorization": "123456" }, "service": "manual", "shipment_status": null, "status": "failure", "tracking_company": "USPS", "tracking_number": "1Z1234512345123456", "tracking_numbers": [ "1Z1234512345123456" ], "tracking_url": "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z1234512345123456", "tracking_urls": [ "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z1234512345123456" ], "updated_at": "2024-10-01T13:46:05-04:00", "line_items": [ { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] } ] } ], "line_items": [ { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] }, { "id": 518995019, "admin_graphql_api_id": "gid://shopify/LineItem/518995019", "attributed_staffs": [], "current_quantity": 1, "fulfillable_quantity": 1, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - red", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008RED", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 49148385, "variant_inventory_management": "shopify", "variant_title": "red", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] }, { "id": 703073504, "admin_graphql_api_id": "gid://shopify/LineItem/703073504", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - black", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008BLACK", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 457924702, "variant_inventory_management": "shopify", "variant_title": "black", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] } ], "payment_terms": null, "refunds": [ { "id": 509562969, "admin_graphql_api_id": "gid://shopify/Refund/509562969", "created_at": "2024-10-01T13:46:05-04:00", "note": "it broke during shipping", "order_id": 450789469, "processed_at": "2024-10-01T13:46:05-04:00", "restock": true, "total_additional_fees_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "total_duties_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "user_id": 548380009, "order_adjustments": [], "transactions": [ { "id": 179259969, "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969", "amount": "209.00", "authorization": "authorization-key", "created_at": "2005-08-05T12:59:12-04:00", "currency": "USD", "device_id": null, "error_code": null, "gateway": "bogus", "kind": "refund", "location_id": null, "message": null, "order_id": 450789469, "parent_id": 801038806, "payment_id": "#1001.3", "processed_at": "2005-08-05T12:59:12-04:00", "receipt": {}, "source_name": "web", "status": "success", "test": false, "user_id": null } ], "refund_line_items": [ { "id": 104689539, "line_item_id": 703073504, "location_id": 487838322, "quantity": 1, "restock_type": "legacy_restock", "subtotal": 195.66, "subtotal_set": { "shop_money": { "amount": "195.66", "currency_code": "USD" }, "presentment_money": { "amount": "195.66", "currency_code": "USD" } }, "total_tax": 3.98, "total_tax_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "line_item": { "id": 703073504, "admin_graphql_api_id": "gid://shopify/LineItem/703073504", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - black", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008BLACK", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 457924702, "variant_inventory_management": "shopify", "variant_title": "black", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.33", "amount_set": { "shop_money": { "amount": "3.33", "currency_code": "USD" }, "presentment_money": { "amount": "3.33", "currency_code": "USD" } }, "discount_application_index": 0 } ] } }, { "id": 709875399, "line_item_id": 466157049, "location_id": 487838322, "quantity": 1, "restock_type": "legacy_restock", "subtotal": 195.67, "subtotal_set": { "shop_money": { "amount": "195.67", "currency_code": "USD" }, "presentment_money": { "amount": "195.67", "currency_code": "USD" } }, "total_tax": 3.98, "total_tax_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "line_item": { "id": 466157049, "admin_graphql_api_id": "gid://shopify/LineItem/466157049", "attributed_staffs": [], "current_quantity": 0, "fulfillable_quantity": 0, "fulfillment_service": "manual", "fulfillment_status": null, "gift_card": false, "grams": 200, "name": "IPod Nano - 8gb - green", "price": "199.00", "price_set": { "shop_money": { "amount": "199.00", "currency_code": "USD" }, "presentment_money": { "amount": "199.00", "currency_code": "USD" } }, "product_exists": true, "product_id": 632910392, "properties": [ { "name": "Custom Engraving Front", "value": "Happy Birthday" }, { "name": "Custom Engraving Back", "value": "Merry Christmas" } ], "quantity": 1, "requires_shipping": true, "sku": "IPOD2008GREEN", "taxable": true, "title": "IPod Nano - 8gb", "total_discount": "0.00", "total_discount_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "variant_id": 39072856, "variant_inventory_management": "shopify", "variant_title": "green", "vendor": null, "tax_lines": [ { "channel_liable": null, "price": "3.98", "price_set": { "shop_money": { "amount": "3.98", "currency_code": "USD" }, "presentment_money": { "amount": "3.98", "currency_code": "USD" } }, "rate": 0.06, "title": "State Tax" } ], "duties": [], "discount_allocations": [ { "amount": "3.34", "amount_set": { "shop_money": { "amount": "3.34", "currency_code": "USD" }, "presentment_money": { "amount": "3.34", "currency_code": "USD" } }, "discount_application_index": 0 } ] } } ], "duties": [], "additional_fees": [] } ], "shipping_address": { "first_name": "Bob", "address1": "Chestnut Street 92", "phone": "+1(502)-459-2181", "city": "Louisville", "zip": "40202", "province": "Kentucky", "country": "United States", "last_name": "Norman", "address2": "", "company": null, "latitude": 45.41634, "longitude": -75.6868, "name": "Bob Norman", "country_code": "US", "province_code": "KY" }, "shipping_lines": [ { "id": 369256396, "carrier_identifier": null, "code": "Free Shipping", "discounted_price": "0.00", "discounted_price_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "is_removed": false, "phone": null, "price": "0.00", "price_set": { "shop_money": { "amount": "0.00", "currency_code": "USD" }, "presentment_money": { "amount": "0.00", "currency_code": "USD" } }, "requested_fulfillment_service_id": null, "source": "shopify", "title": "Free Shipping", "tax_lines": [], "discount_allocations": [] } ] } }
delDelete an order
orders
access scope.
curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2024-10/orders/450789469.json" \ -H "X-Shopify-Access-Token: {access_token}"
HTTP/1.1 200 OK {}