Solar 4 RVs Customer API

cURL — products

curl "https://api.solar4rvs.com.au/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Customer-Email: [email protected]"

Node.js fetch example

const response = await fetch("https://api.solar4rvs.com.au/products", {
  headers: {
    Authorization: "Bearer " + process.env.CUSTOMER_API_KEY,
    "X-Customer-Email": process.env.CUSTOMER_API_EMAIL,
  },
});

if (!response.ok) {
  throw new Error(`API request failed: ${response.status}`);
}

const payload = await response.json();
console.log(payload.length);

cURL — order

curl "https://api.solar4rvs.com.au/order" \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Customer-Email: [email protected]" \
  -H "Content-Type: application/json" \
  --data '{
    "po": "PO-1001",
    "address": {
      "firstName": "Alex",
      "lastName": "Buyer",
      "company": "Acme RV Services",
      "address1": "1 Example Street",
      "address2": "Unit 4",
      "city": "Melbourne",
      "state": "VIC",
      "postcode": "3000"
    },
    "lines": [{ "sku": "ABC-123", "quantity": 2 }],
    "orderType": "dropship",
    "courierType": "express",
    "draftOnly": true
  }'

Products response

[
  {
    "sku": "ABC-123",
    "productTitle": "Example Product",
    "barcode": "1234567890123",
    "brand": "Example Brand",
    "quantity": 12,
    "price": "90.91",
    "breakpoints": [
      {
        "min_qty": 10,
        "price": "55.00"
      },
      {
        "min_qty": 20,
        "price": "54.00"
      }
    ],
    "weight": 1.25,
    "shipping": {
      "length": 0.5,
      "width": 0.3,
      "height": 0.2
    },
    "updatedAt": "2026-05-07T00:00:00.000Z"
  }
]

Order response

{
  "po": "PO-1001",
  "name": "#S278743",
  "address": {
    "firstName": "Alex",
    "lastName": "Buyer",
    "company": "Acme RV Services",
    "address1": "1 Example Street",
    "address2": "Unit 4",
    "city": "Melbourne",
    "state": "Victoria",
    "postcode": "3000",
    "phone": "0400000000"
  },
  "skus": [
    {
      "sku": "ABC-123",
      "quantity": 2
    }
  ],
  "orderType": "dropship",
  "courierType": "express",
  "authorityToLeave": true,
  "draftOnly": false,
  "currencyCode": "AUD",
  "costs": {
    "lineItems": [
      {
        "sku": "ABC-123",
        "productTitle": "Example Product",
        "quantity": 2,
        "unitCostExGst": "2.16",
        "lineItemCostExGst": "4.32",
        "lineItemCostInclGst": "4.75"
      }
    ],
    "shippingCostExGst": "12.95",
    "shippingCostInclGst": "14.25",
    "totalExGst": "17.27",
    "totalInclGst": "19.00",
    "gst": "1.73"
  },
  "account": {
    "companyName": "Example Company",
    "creditLimit": "500.00",
    "outstandingBeforeOrder": "0.00",
    "overdueInvoices": []
  }
}

Example permission error response

{
  "error": {
    "code": "insufficient_scope",
    "message": "This API key does not include access to /products."
  }
}

This is returned when an order-only key calls /products. Calling /order with a product-only key returns the same 403 insufficient_scope structure with the message This API key cannot create orders.

Example rate limit response

{
  "error": {
    "code": "rate_limited",
    "message": "Too many order API requests. Try again shortly."
  }
}

Operational notes

• Keys can be granted access to /products, /order, or both. Calling an endpoint the key does not include returns 403 insufficient_scope.
• Rate limits are enforced in Redis per credential, customer email, and source IP.
• /products is capped at 1 request per 15 seconds, 15 per hour, and 360 per day.
• /order is capped at 1 request per 2 minutes.
• Weight values are normalised to kilograms. Shipping length, width, and height are read from product metafields and normalized to metres.
• Expired keys return 401 expired_credentials until they are extended back to 2 years.
• A 429 response includes a Retry-After header.