Get Order
curl --request GET \
--url https://api.launchmystore.io/api/v1/orders/:id.json \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.launchmystore.io/api/v1/orders/:id.json"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.launchmystore.io/api/v1/orders/:id.json', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.launchmystore.io/api/v1/orders/:id.json",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.launchmystore.io/api/v1/orders/:id.json"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.launchmystore.io/api/v1/orders/:id.json")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.launchmystore.io/api/v1/orders/:id.json")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"order": {
"id": "<string>",
"name": "<string>",
"order_number": 123,
"email": "<string>",
"phone": "<string>",
"financial_status": "<string>",
"fulfillment_status": "<string>",
"cancelled": true,
"cancelled_at": "<string>",
"cancel_reason": "<string>",
"currency": "<string>",
"presentment_currency": "<string>",
"subtotal_price": "<string>",
"tax_price": "<string>",
"shipping_price": "<string>",
"total_discounts": "<string>",
"total_price": "<string>",
"total_refunded_amount": "<string>",
"total_net_amount": "<string>",
"item_count": 123,
"line_items": [
{}
],
"customer": {},
"shipping_address": {},
"billing_address": {},
"shipping_methods": [
{}
],
"shipping_lines": [
{}
],
"tax_lines": [
{}
],
"transactions": [
{}
],
"discount_applications": [
{}
],
"metafields": {},
"attributes": [
{}
],
"note": "<string>",
"tags": [
{}
],
"tracking_number": "<string>",
"tracking_url": "<string>",
"order_status_url": "<string>",
"confirmation_number": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"processed_at": "<string>"
}
}Orders
Get Order
Retrieve a single order by ID
GET
/
api
/
v1
/
orders
/
:id.json
Get Order
curl --request GET \
--url https://api.launchmystore.io/api/v1/orders/:id.json \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.launchmystore.io/api/v1/orders/:id.json"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.launchmystore.io/api/v1/orders/:id.json', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.launchmystore.io/api/v1/orders/:id.json",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.launchmystore.io/api/v1/orders/:id.json"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.launchmystore.io/api/v1/orders/:id.json")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.launchmystore.io/api/v1/orders/:id.json")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"order": {
"id": "<string>",
"name": "<string>",
"order_number": 123,
"email": "<string>",
"phone": "<string>",
"financial_status": "<string>",
"fulfillment_status": "<string>",
"cancelled": true,
"cancelled_at": "<string>",
"cancel_reason": "<string>",
"currency": "<string>",
"presentment_currency": "<string>",
"subtotal_price": "<string>",
"tax_price": "<string>",
"shipping_price": "<string>",
"total_discounts": "<string>",
"total_price": "<string>",
"total_refunded_amount": "<string>",
"total_net_amount": "<string>",
"item_count": 123,
"line_items": [
{}
],
"customer": {},
"shipping_address": {},
"billing_address": {},
"shipping_methods": [
{}
],
"shipping_lines": [
{}
],
"tax_lines": [
{}
],
"transactions": [
{}
],
"discount_applications": [
{}
],
"metafields": {},
"attributes": [
{}
],
"note": "<string>",
"tags": [
{}
],
"tracking_number": "<string>",
"tracking_url": "<string>",
"order_status_url": "<string>",
"confirmation_number": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"processed_at": "<string>"
}
}Get Order
Returns a single order with full details including line items, customer information, and fulfillment data.Request
curl -X GET "https://api.launchmystore.io/api/v1/orders/ord_abc123.json" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Parameters
The unique order ID
Response
On success the order is returned underorder, with full details
including its line items. Money fields are decimal strings (e.g.
"54.50"), matching the products surface — not integer cents.
The order object
Show Order Object
Show Order Object
Unique order ID (UUID)
Display name, e.g.
#1001Human-readable order number
Customer email
Customer phone number
Payment status:
pending, paid, partially_paid, refunded, partially_refundedFulfillment status:
unfulfilled, partial, fulfilledWhether the order has been cancelled
Cancellation timestamp (ISO 8601), or
nullCancellation reason, or
nullOrder currency code (ISO 4217)
Currency presented to the customer (ISO 4217)
Subtotal before tax and shipping (decimal string)
Total tax amount (decimal string)
Total shipping cost (decimal string)
Total discounts applied (decimal string)
Final total (decimal string)
Total amount refunded (decimal string)
Total minus refunds (decimal string)
Total quantity across line items
Array of order line items. Each item includes
id, product_id,
variant_id, quantity, title, sku, price, line_price,
final_price, final_line_price, total_discount (money fields are
decimal strings), fulfillment_status, requires_shipping,
taxable, and properties ([[key, value]] pairs).Customer information
Shipping address details
Billing address details
Selected shipping method(s)
Shipping line(s).
source carries the shipping app’s handle — the
routing key apps match against to recognise their own rate.Tax line breakdown
Payment transaction records
Applied discounts (
{ type, code, value, value_type, title })Order metafields grouped by namespace
Additional order fields (cart/checkout attributes)
Order note, or
nullOrder tags
Tracking number, or
nullTracking URL, or
nullCustomer-facing order status URL
Order confirmation / invoice number
Creation timestamp (ISO 8601)
Last update timestamp (ISO 8601)
Processing timestamp (ISO 8601)
There is no top-level
status field — payment and fulfillment state
are exposed separately as financial_status and fulfillment_status.Example Response
{
"order": {
"id": "9f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
"name": "#1001",
"order_number": 1001,
"email": "customer@example.com",
"phone": "+1-555-123-4567",
"financial_status": "paid",
"fulfillment_status": "unfulfilled",
"cancelled": false,
"cancelled_at": null,
"cancel_reason": null,
"currency": "USD",
"presentment_currency": "USD",
"subtotal_price": "50.00",
"tax_price": "4.50",
"shipping_price": "5.00",
"total_discounts": "5.00",
"total_price": "54.50",
"total_refunded_amount": "0.00",
"total_net_amount": "54.50",
"item_count": 2,
"line_items": [
{
"id": "li_xyz789",
"product_id": "prod_abc123",
"variant_id": "var_xyz789",
"title": "Classic T-Shirt",
"variant_title": "Small / Black",
"quantity": 2,
"price": "25.00",
"line_price": "50.00",
"final_price": "25.00",
"final_line_price": "50.00",
"total_discount": "0.00",
"sku": "TSHIRT-S-BLK",
"requires_shipping": true,
"taxable": true,
"fulfillment_status": null,
"properties": []
}
],
"customer": {
"id": "cust_123",
"email": "customer@example.com",
"first_name": "John",
"last_name": "Doe",
"phone": "+1-555-123-4567"
},
"shipping_address": {
"first_name": "John",
"last_name": "Doe",
"company": "Acme Inc",
"address1": "123 Main St",
"address2": "Apt 4B",
"city": "New York",
"province": "NY",
"province_code": "NY",
"country": "United States",
"country_code": "US",
"zip": "10001",
"phone": "+1-555-123-4567"
},
"billing_address": {
"first_name": "John",
"last_name": "Doe",
"address1": "123 Main St",
"city": "New York",
"province": "NY",
"country": "United States",
"country_code": "US",
"zip": "10001"
},
"shipping_methods": [
{
"handle": "standard",
"title": "Standard Shipping",
"price": "5.00",
"original_price": "5.00"
}
],
"shipping_lines": [
{
"title": "Standard Shipping",
"code": "standard",
"source": null,
"price": "5.00",
"currency": "USD"
}
],
"tax_lines": [
{ "title": "Tax", "price": "4.50", "rate": 0 }
],
"transactions": [
{
"id": "txn_123",
"amount": "54.50",
"kind": "sale",
"status": "success",
"gateway": "manual",
"created_at": "2024-01-20T14:30:00Z"
}
],
"discount_applications": [
{
"type": "discount_code",
"code": "SAVE10",
"value": "5.00",
"value_type": "fixed_amount",
"title": "SAVE10"
}
],
"metafields": {},
"attributes": [],
"note": "Please leave at the door",
"tags": ["VIP", "first-order"],
"tracking_number": null,
"tracking_url": null,
"order_status_url": "/orders/9f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f/status",
"confirmation_number": "1001",
"created_at": "2024-01-20T14:30:00Z",
"updated_at": "2024-01-20T14:35:00Z",
"processed_at": "2024-01-20T14:30:00Z"
}
}
Error Codes
| Status | Description |
|---|---|
401 | Invalid or missing access token |
403 | App doesn’t have the read_orders scope |
404 | Order with the specified ID does not exist |
⌘I