API Documentation

Overview

The LUXE API is organized around REST. Our API accepts JSON request bodies, returns JSON responses, and uses standard HTTP response codes.

Base URL: https://api.luxe.com/v1

Rate Limits: 1000 requests per minute for standard tier, 5000 for enterprise partners.

Response Format

All responses are returned in JSON format with a consistent envelope structure:

{
  "success": true,
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-04-07T15:00:00Z"
  }
}

Authentication

The LUXE API uses API keys to authenticate requests. Include your API key in the Authorization header of all requests.

Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://api.luxe.com/v1/products

Obtaining API Keys

API keys are available through the LUXE Partner Portal. Contact partners@luxe.com for partnership inquiries.

Products

Retrieve and manage product catalog data including pricing, inventory, and media assets.

List Products

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://api.luxe.com/v1/products?limit=10&category=dresses"

Get Product

Create Product

{
  "name": "Silk Wrap Dress",
  "sku": "DRL-SWK-001",
  "price": 89000,
  "currency": "USD",
  "category": "dresses",
  "description": "Elegant silk wrap dress...",
  "sizes": ["XS", "S", "M", "L", "XL"],
  "inventory": {
    "XS": 12,
    "S": 24,
    "M": 30,
    "L": 18,
    "XL": 8
  }
}

Orders

Manage customer orders including creation, status updates, and fulfillment tracking.

List Orders

Get Order

Create Order

{
  "customer_id": "cus_abc123",
  "line_items": [
    {
      "product_id": "prod_xyz789",
      "sku": "DRL-SWK-001",
      "size": "M",
      "quantity": 1,
      "price": 89000
    }
  ],
  "shipping_address": {
    "name": "Sofia Chen",
    "line1": "123 Madison Ave",
    "city": "New York",
    "state": "NY",
    "postal_code": "10016",
    "country": "US"
  },
  "shipping_method": "standard"
}

Update Order Status

{
  "status": "fulfilled",
  "tracking_number": "1Z999AA10123456784",
  "tracking_carrier": "UPS"
}

Customers

Access and manage customer profiles, addresses, and order history.

List Customers

Get Customer

Create Customer

{
  "email": "sofia.chen@example.com",
  "first_name": "Sofia",
  "last_name": "Chen",
  "phone": "+1-555-123-4567",
  "default_address": {
    "line1": "123 Madison Ave",
    "city": "New York",
    "state": "NY",
    "postal_code": "10016",
    "country": "US"
  }
}

Error Codes