Skip to main content
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>'
{
  "success": true,
  "data": {
    "id": "<string>",
    "order_number": 123,
    "email": "<string>",
    "phone": "<string>",
    "status": "<string>",
    "financial_status": "<string>",
    "fulfillment_status": "<string>",
    "currency": "<string>",
    "subtotal_price": 123,
    "total_tax": 123,
    "total_shipping": 123,
    "total_discounts": 123,
    "total_price": 123,
    "line_items": [
      {}
    ],
    "customer": {},
    "shipping_address": {},
    "billing_address": {},
    "fulfillments": [
      {}
    ],
    "refunds": [
      {}
    ],
    "discount_codes": [
      {}
    ],
    "note": "<string>",
    "note_attributes": [
      {}
    ],
    "tags": [
      {}
    ],
    "created_at": "<string>",
    "updated_at": "<string>",
    "closed_at": "<string>",
    "cancelled_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

​
id
string
required
The unique order ID
​
fields
string
Comma-separated list of fields to include in the response

​
Response

​
success
boolean
Whether the request succeeded
​
data
object
The order object

​
Example Response

{
  "success": true,
  "data": {
    "id": "ord_abc123",
    "order_number": 1001,
    "email": "customer@example.com",
    "phone": "+1-555-123-4567",
    "status": "confirmed",
    "financial_status": "paid",
    "fulfillment_status": "unfulfilled",
    "currency": "USD",
    "subtotal_price": 5000,
    "total_tax": 450,
    "total_shipping": 500,
    "total_discounts": 500,
    "total_price": 5450,
    "line_items": [
      {
        "id": "li_xyz789",
        "product_id": "prod_abc123",
        "variant_id": "var_xyz789",
        "title": "Classic T-Shirt",
        "variant_title": "Small / Black",
        "quantity": 2,
        "price": 2500,
        "total": 5000,
        "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",
      "orders_count": 5,
      "total_spent": 25000
    },
    "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"
    },
    "fulfillments": [],
    "refunds": [],
    "discount_codes": [
      {
        "code": "SAVE10",
        "amount": 500,
        "type": "fixed_amount"
      }
    ],
    "note": "Please leave at the door",
    "note_attributes": [],
    "tags": ["VIP", "first-order"],
    "created_at": "2024-01-20T14:30:00Z",
    "updated_at": "2024-01-20T14:35:00Z",
    "closed_at": null,
    "cancelled_at": null
  }
}

​
Error Codes

CodeDescription
UNAUTHORIZEDInvalid or missing access token
FORBIDDENApp doesn’t have read_orders scope
NOT_FOUNDOrder with the specified ID does not exist