Skip to content
Developer documentation

WMS API

Automate your warehouse with the SmartWMS REST API — stock, orders, receiving, picking, waves and integrations. JWT-secured, multi-tenant, real-time via SignalR.

REST + JSON

Predictable resources over HTTPS with JSON bodies.

JWT auth

Bearer tokens, tenant-scoped and isolated.

Full coverage

Stock, orders, receiving, picking, waves, analytics.

Real-time

SignalR events for stock, orders and receipts.

Quickstart

Base URL: https://api.smartwms.one/api/v1

Authenticate to receive a JWT, then call tenant-scoped resources under /tenant/{tenantId}/…

# 1. Authenticate and get a JWT
curl -X POST https://api.smartwms.one/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{ "email": "you@company.com", "password": "••••••••" }'

# 2. Call a tenant-scoped resource with the token
curl https://api.smartwms.one/api/v1/tenant/$TENANT_ID/stock \
  -H "Authorization: Bearer $SMARTWMS_TOKEN"

Core resources

GET/POST/stockStock levels, movements and adjustments by location
GET/POST/sales-ordersCreate and manage outbound sales orders
GET/POST/purchase-ordersInbound purchase orders
GET/POST/receiving/goods-receiptsGoods receipts and ASN processing
GET/POST/fulfillment/pick-tasksPick tasks and fulfillment batches
POST/wavesWave planning and release for batch picking
POST/putawayPutaway scoring and location assignment
GET/analyticsABC analysis, productivity and fulfillment metrics
GET/POST/integrationsMarketplace & ERP integrations (e.g. Shopify)

Plus transfers, cycle counts, slotting, reports, notifications and more — all tenant-scoped.

Frequently asked questions

Does SmartWMS have a REST API?

Yes. SmartWMS exposes a full REST API at https://api.smartwms.one/api/v1. Every warehouse object — stock, products, sales and purchase orders, goods receipts, pick tasks, waves, putaway, transfers, cycle counts, analytics and integrations — is available over HTTPS with JSON request and response bodies.

How does authentication work?

The API uses JWT Bearer tokens. You authenticate against /api/v1/auth to receive an access token, then send it as an Authorization: Bearer <token> header. Tokens are scoped to your tenant, so every request is automatically isolated to your warehouse data.

Is the API multi-tenant?

Yes. Resource endpoints are tenant-scoped under /api/v1/tenant/{tenantId}/… and access is validated on every call, so one account can never read or write another tenant’s data.

Can I receive real-time warehouse events?

Yes. Beyond REST, SmartWMS pushes real-time events (stock changes, order and receipt updates) over SignalR, so dashboards and integrations stay in sync without polling.

Can I integrate marketplaces and ERPs through the API?

Yes. The integrations endpoints connect external systems such as Shopify and other marketplaces/ERPs, syncing orders and stock both ways. Custom integrations can be built directly on the REST API.

Build on SmartWMS

Connect your store, ERP or custom app to a warehouse system that speaks REST.