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
integer
default:"1"
Page number for pagination
integer
default:"50"
Number of results per page
string
Filter by order status. One of:
pending, confirmed, processing, shipped, delivered, cancelledstring
Return only orders with an ID greater than the supplied value
Response
This endpoint returns a bare response 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
Array of order objects
Show Order Object
Show Order Object
string
Unique order ID
string
Order name (e.g.
#1001)integer
Human-readable order number
string
Customer email
string
Customer phone
string
Payment status
string
Fulfillment status
string
Subtotal as a decimal string
string
Total tax as a decimal string
string
Total shipping cost as a decimal string
string
Total discounts as a decimal string
string
Total price as a decimal string
array
Array of line items
object
Customer information
object
Shipping address
object
Billing address
array
Chosen shipping rate(s)
string
Creation timestamp (ISO 8601)
string
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 standard{ 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