Get Order

curl --request GET \
  --url https://api.launchmystore.io/api/v1/orders/:id.json \
  --header 'Authorization: Bearer <token>'

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))

}

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

api

orders

:id.json

Get Order

curl --request GET \
  --url https://api.launchmystore.io/api/v1/orders/:id.json \
  --header 'Authorization: Bearer <token>'

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))

}

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

string

required

The unique order ID

Response

On success the order is returned under order, with full details including its line items. Money fields are decimal strings (e.g. "54.50"), matching the products surface — not integer cents.

object

The order object

Show Order Object

string

Unique order ID (UUID)

string

Display name, e.g. #1001

integer

Human-readable order number

string

Customer email

string

Customer phone number

string

Payment status: pending, paid, partially_paid, refunded, partially_refunded

string

Fulfillment status: unfulfilled, partial, fulfilled

boolean

Whether the order has been cancelled

string

Cancellation timestamp (ISO 8601), or null

string

Cancellation reason, or null

string

Order currency code (ISO 4217)

string

Currency presented to the customer (ISO 4217)

string

Subtotal before tax and shipping (decimal string)

string

Total tax amount (decimal string)

string

Total shipping cost (decimal string)

string

Total discounts applied (decimal string)

string

Final total (decimal string)

string

Total amount refunded (decimal string)

string

Total minus refunds (decimal string)

integer

Total quantity across line items

array

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).

object

Customer information

object

Shipping address details

object

Billing address details

array

Selected shipping method(s)

array

Shipping line(s). source carries the shipping app’s handle — the routing key apps match against to recognise their own rate.

array

Tax line breakdown

array

Payment transaction records

array

Applied discounts ({ type, code, value, value_type, title })

object

Order metafields grouped by namespace

array

Additional order fields (cart/checkout attributes)

string

Order note, or null

array

Order tags

string

Tracking number, or null

string

Tracking URL, or null

string

Customer-facing order status URL

string

Order confirmation / invoice number

string

Creation timestamp (ISO 8601)

string

Last update timestamp (ISO 8601)

string

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

List Orders Create Order

​Get Order

​Request

​Parameters

​Response

​Example Response

​Error Codes

Get Order

Request

Parameters

Response

Example Response

Error Codes