List Orders
curl --request GET \
--url https://api.launchmystore.io/api/v1/orders.json \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.launchmystore.io/api/v1/orders.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.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.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.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.json")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.launchmystore.io/api/v1/orders.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{
"orders": [
{
"id": "<string>",
"name": "<string>",
"order_number": 123,
"email": "<string>",
"phone": "<string>",
"financial_status": "<string>",
"fulfillment_status": "<string>",
"subtotal_price": "<string>",
"tax_price": "<string>",
"shipping_price": "<string>",
"total_discounts": "<string>",
"total_price": "<string>",
"line_items": [
{}
],
"customer": {},
"shipping_address": {},
"billing_address": {},
"shipping_lines": [
{}
],
"created_at": "<string>",
"updated_at": "<string>"
}
]
}Orders
List Orders
Retrieve a list of orders
GET
/
api
/
v1
/
orders.json
List Orders
curl --request GET \
--url https://api.launchmystore.io/api/v1/orders.json \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.launchmystore.io/api/v1/orders.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.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.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.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.json")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.launchmystore.io/api/v1/orders.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{
"orders": [
{
"id": "<string>",
"name": "<string>",
"order_number": 123,
"email": "<string>",
"phone": "<string>",
"financial_status": "<string>",
"fulfillment_status": "<string>",
"subtotal_price": "<string>",
"tax_price": "<string>",
"shipping_price": "<string>",
"total_discounts": "<string>",
"total_price": "<string>",
"line_items": [
{}
],
"customer": {},
"shipping_address": {},
"billing_address": {},
"shipping_lines": [
{}
],
"created_at": "<string>",
"updated_at": "<string>"
}
]
}List Orders
Returns a paginated list of orders for the store.Request
curl -X GET "https://api.launchmystore.io/api/v1/orders.json" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Parameters
Page number for pagination
Number of results per page
Filter by order status. One of:
pending, confirmed, processing, shipped, delivered, cancelledReturn only orders with an ID greater than the supplied value
Response
This endpoint returns a Shopify-style body: a bare object whoseorders key holds the array of orders. There is no success/envelope wrapper. Pagination is conveyed through the RFC-5988 Link response header (rel="next" / rel="previous") rather than a body field, and the resolved contract version is returned in the X-LMS-Api-Version header. Monetary values are decimal strings (for example "59.50").
Array of order objects
Show Order Object
Show Order Object
Unique order ID
Order name (e.g.
#1001)Human-readable order number
Customer email
Customer phone
Payment status
Fulfillment status
Subtotal as a decimal string
Total tax as a decimal string
Total shipping cost as a decimal string
Total discounts as a decimal string
Total price as a decimal string
Array of line items
Customer information
Shipping address
Billing address
Chosen shipping rate(s)
Creation timestamp (ISO 8601)
Last update timestamp (ISO 8601)
Example Response
Link: <https://api.launchmystore.io/api/v1/orders.json?limit=50&page=2>; rel="next"
X-LMS-Api-Version: 2026-06
{
"orders": [
{
"id": "b2c3d4e5-1001-4f6a-8b9c-0d1e2f3a4b5c",
"name": "#1001",
"order_number": 1001,
"email": "customer@example.com",
"phone": "",
"financial_status": "paid",
"fulfillment_status": "unfulfilled",
"subtotal_price": "50.00",
"tax_price": "4.50",
"shipping_price": "5.00",
"total_discounts": "0.00",
"total_price": "59.50",
"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",
"sku": "TSHIRT-S-BLK"
}
],
"customer": {
"id": "cust-123",
"email": "customer@example.com",
"first_name": "John",
"last_name": "Doe"
},
"shipping_address": {
"first_name": "John",
"last_name": "Doe",
"address1": "123 Main St",
"city": "New York",
"province": "NY",
"country": "US",
"zip": "10001"
},
"billing_address": {
"first_name": "John",
"last_name": "Doe",
"address1": "123 Main St",
"city": "New York",
"province": "NY",
"country": "US",
"zip": "10001"
},
"shipping_lines": [
{
"title": "Standard",
"code": "standard",
"source": null,
"price": "5.00",
"currency": "USD"
}
],
"created_at": "2024-01-20T14:30:00.000Z",
"updated_at": "2024-01-20T14:35:00.000Z"
}
]
}
Error Response
Errors on the app surface use a Shopify-style{ errors } body:
{
"errors": {
"base": ["Unauthorized"]
}
}
Error Codes
| HTTP Status | Description |
|---|---|
401 | Invalid or missing access token |
403 | App doesn’t have read_orders scope |
422 | Invalid query parameter (e.g. an unsupported status value) |
⌘I