> ## Documentation Index
> Fetch the complete documentation index at: https://docs.launchmystore.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Order

> Retrieve a single order by ID

# Get Order

Returns a single order with full details including line items, customer information, and fulfillment data.

## Request

```bash theme={null}
curl -X GET "https://api.launchmystore.io/api/v1/orders/ord_abc123.json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

## Parameters

<ParamField path="id" type="string" required>
  The unique order ID
</ParamField>

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

<ResponseField name="order" type="object">
  The order object

  <Expandable title="Order Object">
    <ResponseField name="id" type="string">
      Unique order ID (UUID)
    </ResponseField>

    <ResponseField name="name" type="string">
      Display name, e.g. `#1001`
    </ResponseField>

    <ResponseField name="order_number" type="integer">
      Human-readable order number
    </ResponseField>

    <ResponseField name="email" type="string">
      Customer email
    </ResponseField>

    <ResponseField name="phone" type="string">
      Customer phone number
    </ResponseField>

    <ResponseField name="financial_status" type="string">
      Payment status: `pending`, `paid`, `partially_paid`, `refunded`, `partially_refunded`
    </ResponseField>

    <ResponseField name="fulfillment_status" type="string">
      Fulfillment status: `unfulfilled`, `partial`, `fulfilled`
    </ResponseField>

    <ResponseField name="cancelled" type="boolean">
      Whether the order has been cancelled
    </ResponseField>

    <ResponseField name="cancelled_at" type="string">
      Cancellation timestamp (ISO 8601), or `null`
    </ResponseField>

    <ResponseField name="cancel_reason" type="string">
      Cancellation reason, or `null`
    </ResponseField>

    <ResponseField name="currency" type="string">
      Order currency code (ISO 4217)
    </ResponseField>

    <ResponseField name="presentment_currency" type="string">
      Currency presented to the customer (ISO 4217)
    </ResponseField>

    <ResponseField name="subtotal_price" type="string">
      Subtotal before tax and shipping (decimal string)
    </ResponseField>

    <ResponseField name="tax_price" type="string">
      Total tax amount (decimal string)
    </ResponseField>

    <ResponseField name="shipping_price" type="string">
      Total shipping cost (decimal string)
    </ResponseField>

    <ResponseField name="total_discounts" type="string">
      Total discounts applied (decimal string)
    </ResponseField>

    <ResponseField name="total_price" type="string">
      Final total (decimal string)
    </ResponseField>

    <ResponseField name="total_refunded_amount" type="string">
      Total amount refunded (decimal string)
    </ResponseField>

    <ResponseField name="total_net_amount" type="string">
      Total minus refunds (decimal string)
    </ResponseField>

    <ResponseField name="item_count" type="integer">
      Total quantity across line items
    </ResponseField>

    <ResponseField name="line_items" type="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).
    </ResponseField>

    <ResponseField name="customer" type="object">
      Customer information
    </ResponseField>

    <ResponseField name="shipping_address" type="object">
      Shipping address details
    </ResponseField>

    <ResponseField name="billing_address" type="object">
      Billing address details
    </ResponseField>

    <ResponseField name="shipping_methods" type="array">
      Selected shipping method(s)
    </ResponseField>

    <ResponseField name="shipping_lines" type="array">
      Shipping line(s). `source` carries the shipping app's handle — the
      routing key apps match against to recognise their own rate.
    </ResponseField>

    <ResponseField name="tax_lines" type="array">
      Tax line breakdown
    </ResponseField>

    <ResponseField name="transactions" type="array">
      Payment transaction records
    </ResponseField>

    <ResponseField name="discount_applications" type="array">
      Applied discounts (`{ type, code, value, value_type, title }`)
    </ResponseField>

    <ResponseField name="metafields" type="object">
      Order metafields grouped by namespace
    </ResponseField>

    <ResponseField name="attributes" type="array">
      Additional order fields (cart/checkout attributes)
    </ResponseField>

    <ResponseField name="note" type="string">
      Order note, or `null`
    </ResponseField>

    <ResponseField name="tags" type="array">
      Order tags
    </ResponseField>

    <ResponseField name="tracking_number" type="string">
      Tracking number, or `null`
    </ResponseField>

    <ResponseField name="tracking_url" type="string">
      Tracking URL, or `null`
    </ResponseField>

    <ResponseField name="order_status_url" type="string">
      Customer-facing order status URL
    </ResponseField>

    <ResponseField name="confirmation_number" type="string">
      Order confirmation / invoice number
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Creation timestamp (ISO 8601)
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Last update timestamp (ISO 8601)
    </ResponseField>

    <ResponseField name="processed_at" type="string">
      Processing timestamp (ISO 8601)
    </ResponseField>
  </Expandable>
</ResponseField>

<Note>
  There is **no top-level `status`** field — payment and fulfillment state
  are exposed separately as `financial_status` and `fulfillment_status`.
</Note>

## Example Response

```json theme={null}
{
  "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 |