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...
You can generate and reveal your API key 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"]
}
}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"
}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
}
]
}
]
}Inspect your current API key details, catalog sync mode, remaining monthly quota, rate limits, and live daily usage statistics.
{
"status": "success",
"client_name": "My Reseller Store",
"tier": "growth",
"catalog_mode": "curated",
"selected_skus_count": 24,
"monthly_quota": 20000,
"quota_used_this_month": 1420,
"quota_remaining": 18580,
"rate_limit_rps": 3,
"allowed_endpoints": ["catalog", "stock", "product", "orders"]
}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:
Starter
- 2,000 requests / month
- Full API Access (Catalog, Stock & Orders)
- Standard sync (1–2 hr intervals)
- Ideal for testing & store setup
Growth Partner
- 20,000 requests / month
- 24/7 High-frequency sync (5–15 min)
- Production volume for active stores
- Automated dropship order dispatch
- Priority WhatsApp developer support
Pro Scale
- 75,000 requests / month
- High-frequency multi-store sync
- Blind white-label custom packing
- 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.