API Integration
API Partnership
Connect your store, app or marketplace to our live catalog, stock and order APIs — or plug your products into Specific Supply.
Outgoing API — use our API
Product information, images, categories, prices, authorised wholesale prices, live stock, variations, order placement and delivery tracking.
Incoming API — connect your products
External product import, price and stock sync, order forwarding, and order & delivery status sync.
API reference (v1)
Send your key with every request in the x-api-key header.
| Method | Endpoint | Scope | Description |
|---|---|---|---|
| GET | /api/v1/products | products:read | List products (paginated: ?page, ?limit, ?category, ?q) |
| GET | /api/v1/products/{sku} | products:read | Single product with variants |
| GET | /api/v1/categories | products:read | Category tree |
| GET | /api/v1/stock | stock:read | Live stock for all SKUs (?sku=a,b,c) |
| POST | /api/v1/orders | orders:write | Place an order (Phase 3) |
| GET | /api/v1/orders/{orderNumber} | orders:read | Order & delivery status (Phase 3) |
curl -H "x-api-key: ss_live_demo_key_123" \
"http://localhost:3000/api/v1/products?limit=2"
{
"data": [{ "sku": "SS-P01", "name": { "en": "Wireless Earbuds Pro", "bn": "…" },
"price": 1990, "currency": "BDT", "stock": 140, ... }],
"meta": { "page": 1, "limit": 2, "total": 24 }
}API keys & scopes
Separate keys and permissions per partner.
Security
HTTPS, rate limiting, key revocation and logs.
Webhooks (Phase 3)
Notifications for order and stock changes.