Order API

Send orders from your own website or app straight to our production team.

1. Get a key

Log in to the reseller portal, open the Integrations tab and create a key. It is shown once, so save it. Send it with every call:

Authorization: Bearer pod_live_xxxxxxxxxxxxxxxx

Only approved resellers can use the API. Limit: 120 calls per minute per key. Orders are paid from your wallet exactly like store orders.

2. List the products
curl https://cluesstyle.com/api/pod/v1/products \ -H "Authorization: Bearer pod_live_xxx"

Returns each product's id, basePrice, sizes and colors.

3. Upload the design
curl -X POST https://cluesstyle.com/api/pod/v1/designs \ -H "Authorization: Bearer pod_live_xxx" \ -F "file=@design.png" # -> { "success": true, "url": "/api/pod/file/r12-abc123.png" }
4. Create the order
curl -X POST https://cluesstyle.com/api/pod/v1/orders \ -H "Authorization: Bearer pod_live_xxx" \ -H "Content-Type: application/json" \ -d '{ "productId": 1, "designUrl": "/api/pod/file/r12-abc123.png", "quantity": 1, "size": "M", "color": "Black", "sellingPrice": 599, "collectCod": true, "externalRef": "SHOP-1001", "customer": { "name": "Asha Rao", "phone": "9876543210", "email": "asha@example.com", "address": "12 MG Road, Indiranagar", "city": "Bengaluru", "state": "Karnataka", "pincode": "560038" } }' # -> { "success": true, "orderRef": "POD-ABC123", "status": "new" }
FieldNotes
sellingPricePer piece. Must not be lower than the base price.
collectCodtrue (default): the courier collects sellingPrice × quantity. false: your customer already paid you.
externalRefYour own order number. Sending it again returns the first order (duplicate: true), so a retry never makes a second order.
statusnew = paid from the wallet. on_hold = the wallet was too low; add money and pay it in the portal.
5. Check an order
curl https://cluesstyle.com/api/pod/v1/orders/POD-ABC123 \ -H "Authorization: Bearer pod_live_xxx" # -> { "status": "shipped", "courier": "Delhivery", "trackingNo": "...", "paid": true }

Errors come as { "success": false, "error": "..." } with a normal HTTP status (400 wrong data, 401 bad key, 429 too many calls). Ready-made Shopify and WooCommerce connectors are not available yet; they can be built on this API.