Overview
The Weave365 REST API allows B2B resellers and eCommerce storefronts to query live catalog pricing, verify real-time inventory availability, and automate dropship order fulfillment directly with weavers in Varanasi.
Authentication
All requests must include your secret API key. Pass it in the HTTP headers using either x-api-key or as a standard Bearer token.
x-api-key: w365_live_9a7f8e1b4c3d2e... # OR Authorization: Bearer w365_live_9a7f8e1b4c3d2e...
.env file or server vault. If lost, you can rotate and regenerate a new key anytime from your Developer Dashboard.You can generate and manage your API keys in your Account Developer Dashboard.
Supported Platforms & Integration Guides
Whether you run a Shopify store, WooCommerce, PrestaShop, or a custom Next.js/Node.js web application, Weave365 provides native support:
# Shopify Integration via Live CSV / JSON Sync Feed # 1. Open Matrixify or Stock Sync app in your Shopify Admin # 2. Add a new Scheduled Feed with the following parameters: Feed URL: https://www.weave365.com/api/v1/catalog?format=shopify HTTP Headers: x-api-key: w365_live_YOUR_API_KEY Frequency: Every 1 Hour (or Daily) Update Fields: - Variant Price -> Reseller Procurement Price - Compare At Price -> Suggested Retail MRP - Inventory Quantity -> 5 (In Stock) or 0 (Out of Stock) - Images -> Weave365 High-Resolution CDN URLs
Curated Catalog Product Sync
Weave365 is a curated B2B procurement network. To maintain your storefront's focus, the API only delivers the exact products you choose to list on your store.
| Method | Configuration | API Feed Output |
|---|---|---|
| Dashboard Selection | Checkmark products in Account → Developer API and click Save Selection | /api/v1/catalog and /api/v1/stock-status automatically output strictly your chosen products. |
| URL Parameter Override | Pass ?skus=100001,100005 in the API request URL | Explicit URL query parameters filter the feed directly on demand. |
API Endpoints Reference
Fetches the live Weave365 catalog with high-resolution imagery and strictly the Reseller Procurement Price.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| category | string (optional) | Filter by category (e.g. Kanchipuram Silk, Banarasi Katan). |
| skus | string (optional) | Filter by specific selected SKUs (comma-separated, e.g. 100001,100005,100012). Ideal when only curating selected products. |
| format | string (optional) | Set to shopify to format directly for Shopify Matrixify or automated sync apps. |
Response (JSON)
{
"status": "success",
"tier": "growth",
"client_name": "My Reseller Store",
"catalog_mode": "curated",
"total_products": 24,
"last_synced_at": "2026-08-27T12:00:00Z",
"products": [
{
"id": "100001",
"sku": "100001",
"title": "Pure Kanchipuram Silk Saree",
"category": "Kanchipuram Silk",
"fabric": "Pure Silk",
"weave": "Handloom",
"price": 3500,
"currency": "INR",
"stock_status": "ready-stock",
"stock_status_label": "Ready Stock",
"is_available": true,
"colors": ["Royal Blue", "Crimson Red"],
"images": ["https://assets.weave365.com/products/kan-001.webp"],
"description": "Certified authentic pure silk Banarasi handloom saree."
}
]
}Returns an ultra-compact map of all SKUs and their instant stock availability. Ideal for frequent (every 5-15 minute) inventory polling without consuming bandwidth or heavy payloads.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| skus | string (optional) | Filter stock verification to only specific selected SKUs (comma-separated, e.g. 100001,100005). |
{
"status": "success",
"timestamp": "2026-08-26T12:30:00Z",
"total_items": 240,
"stock_map": {
"100001": {
"title": "Pure Kanchipuram Silk Saree",
"status": "ready-stock",
"is_available": true,
"stock_label": "Ready Stock",
"updated_at": "2026-08-26 12:15:00 IST"
},
"100002": {
"title": "Banarasi Katan Georgette",
"status": "out-of-stock",
"is_available": false,
"stock_label": "Out of Stock",
"updated_at": "2026-08-26 11:40:00 IST"
}
}
}Retrieves real-time details, high-resolution imagery, and live stock availability for a specific product design code / SKU.
{
"status": "success",
"product": {
"id": "100001",
"sku": "100001",
"title": "Pure Kanchipuram Silk Saree",
"category": "Kanchipuram Silk",
"fabric": "Pure Silk",
"price": 3500,
"currency": "INR",
"stock_status": "ready-stock",
"is_available": true,
"colors": ["Royal Blue", "Crimson Red"],
"images": ["https://assets.weave365.com/products/kan-001.webp"]
}
}Curated Feed Error Response (HTTP 404)
If your API key is in curated catalog mode and the requested SKU is not in your selected products list:
{
"status": "error",
"code": "NOT_FOUND",
"message": "Product with SKU 100001 is not found or not included in your curated feed."
}Forward your customer's order directly to the Weave365 fulfillment center in Varanasi. All parcels are dispatched under Blind Packaging (your store name as the sender, zero supplier branding or invoices).
Request Body (JSON)
{
"reseller_order_id": "RESELLER-ORD-1092",
"items": [
{
"sku": "100001",
"color": "Royal Blue",
"quantity": 1
}
],
"shipping_address": {
"name": "Priya Sharma",
"phone": "9876543210",
"address_line1": "Flat 402, Lotus Residency",
"city": "Bengaluru",
"state": "Karnataka",
"pincode": "560001"
},
"packing_preference": "Blind Packaging"
}Response (HTTP 201 Created)
{
"status": "success",
"order_id": "ord_8f7b2a19-3c94",
"reseller_order_id": "RESELLER-ORD-1092",
"message": "Order received successfully and queued for wholesale fulfillment.",
"tracking_url": "https://www.weave365.com/order-tracking/ord_8f7b2a19-3c94",
"estimated_dispatch": "24-48 Business Hours"
}Order API Permission Requirement (HTTP 403)
Dropship ordering requires active Order API permissions (enabled by default on Growth tier or upon partner onboarding approval):
{
"status": "error",
"code": "FORBIDDEN",
"message": "Order API access is not enabled for this API key."
}Retrieve orders placed by your account along with live fulfillment stages, courier carrier, and tracking details.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| id or order_id | string (optional) | Filter by specific Weave365 Order ID (or pass as path: /api/v1/orders/:order_id). |
| reseller_order_id | string (optional) | Filter by your storefront's custom order number (e.g. RESELLER-ORD-1092). |
| status | string (optional) | Filter by order status (new, verified, processing, dispatched, delivered, cancelled). |
| limit | number (optional) | Number of orders to retrieve (default: 50, max: 100). |
Response (HTTP 200 OK)
{
"status": "success",
"total_orders": 1,
"orders": [
{
"id": "ord_8f7b2a19-3c94",
"reseller_order_id": "RESELLER-ORD-1092",
"created_at": "2026-08-27T01:15:00Z",
"status": "dispatched",
"status_label": "Dispatched / In Transit",
"is_dropship": true,
"tracking": {
"carrier": "Delhivery Express",
"tracking_number": "DEL198273645",
"tracking_message": "Dispatched via Delhivery Surface. Expected delivery in 3 days.",
"tracking_url": "https://www.weave365.com/order-tracking/ord_8f7b2a19-3c94",
"is_dispatched": true
},
"customer": {
"name": "Priya Sharma",
"phone": "9876543210",
"address": "Flat 402, Lotus Residency",
"city": "Bengaluru",
"state": "Karnataka",
"pincode": "560001"
},
"items": [
{
"sku": "100001",
"variant_code": "100001",
"color": "Royal Blue",
"quantity": 1
}
]
}
]
}Order API Permission Requirement (HTTP 403)
If Order API permissions are disabled for your key, this endpoint responds with:
{
"status": "error",
"code": "FORBIDDEN",
"message": "Order API access is not enabled for this API key."
}Inspect your current API key details, catalog sync mode, remaining monthly quota, rate limits, active permissions, and live usage statistics.
{
"status": "success",
"client_name": "My Reseller Store",
"client_website": "https://mystore.com",
"tier": "growth",
"monthly_quota": 20000,
"month_total_used": 1420,
"remaining_quota": 18580,
"rate_limit_rps": 3,
"is_active": true,
"orders_enabled": true,
"usage_history": [
{
"usage_date": "2026-08-26",
"total_requests": 142,
"successful_requests": 140,
"rate_limited_requests": 2
}
]
}Rate Limits & Quotas
Request quotas are allocated per calendar month and reset automatically on the 1st of every month at 00:00 UTC. Choose an inventory polling frequency suited to your plan:
| Sync Frequency | Monthly Requests | Recommended Tier |
|---|---|---|
| Every 2 Hours | ~360 req / month | Starter (Free) — Runs smoothly all 30 days |
| Every 1 Hour | ~720 req / month | Starter (Free) — Fits within 2,000 quota |
| Every 15 Minutes | ~2,880 req / month | Growth Partner (₹699) — Continuous 24/7 sync |
| Every 5 Minutes | ~8,640 req / month | Growth Partner (₹699) — Near real-time sync |
Quota Safety Guard
When your monthly quota is reached, endpoints safely respond with HTTP 429 Too Many Requests (code QUOTA_EXCEEDED) to prevent serving outdated stock availability.
{
"status": "error",
"code": "QUOTA_EXCEEDED",
"message": "Monthly API quota of 20,000 requests has been exceeded.",
"upgrade_info": {
"current_tier": "growth",
"monthly_quota": 20000,
"whatsapp_support": "+91 9919101369"
}
}Pricing Tiers
Select a plan matched to your store's monthly catalog sync volume:
For testing & initial catalog sync
- 2,000 requests / month
- Wholesale Catalog & Stock API
- Standard 1–2 hr sync intervals
- Standard community docs & guides
- —Dropship Order API (Growth tier)
For active stores & automated dropshipping
- 20,000 requests / month
- High-frequency 5–15 min live sync
- Automated dropship order dispatch
- Curated feed & multi-sku routing
- Priority WhatsApp developer support
For multi-store brands & high volume
- 75,000 requests / month
- Real-time multi-store catalog sync
- Blind white-label custom packaging
- Priority warehouse dispatch queue
- Dedicated technical account manager
Managing From Your Developer Dashboard
Every registered reseller has full access to the self-service Developer Portal inside their account area:
Key Provisioning
Generate, reveal, copy, or refresh secret API tokens securely.
Live Usage Gauges
Track remaining monthly requests and daily request histograms in real time.
In-Browser Test Console
Send live test queries and view response headers directly in the browser.