Endpoints
Copy any endpoint and check its health. Base URL: …
Health checks only call read-only GET endpoints. POST endpoints are listed for copying and are never called from this page.
Products
List / search products
—Buyable products only (in stock). Add include_sold_out=true for all.
/api/productsSearch products with filters
—Filters: size, color (case-insensitive), max_price in paise (₹499 = 49900).
/api/products?size=M&color=Black&max_price=200000Product detail
—One product with live stock_count. Replace :product_id with a product UUID.
/api/products/:product_idRestock all products
Not auto-checkedAdmin/testing: sets every product to 50 units and available.
/api/products/restockOrders
Order status
Not auto-checkedCurrent status of one order. Replace :order_id with an order UUID.
/api/orders/:order_idPlace order (programmatic / agents)
Not auto-checkedReserves stock and creates a Razorpay order. All amounts in paise.
/api/orders{
"product_id": "<product uuid>",
"customer_name": "Jane Doe",
"customer_email": "jane@example.com",
"quantity": 1,
"discount_percent": 0
}Place order (storefront checkout)
Not auto-checkedOne unit, no discount; returns Checkout.js options.
/api/orders/create{
"product_id": "<product uuid>",
"customer_name": "Jane Doe",
"customer_email": "jane@example.com"
}Verify payment
Not auto-checkedConfirms a Razorpay payment signature for an order.
/api/orders/verifyRazorpay webhook
Not auto-checkedServer-to-server payment events from Razorpay.
/api/orders/webhookCancel expired reservations
Not auto-checkedReleases stock held by unpaid orders (cron). Also accepts POST.
/api/orders/cancel-expiredAdmin & discovery
Admin overview
—Stats, all products and recent orders.
/api/admin/overviewUCP business profile
—Discovery profile for agents, proxied from the Discovery Service.
/.well-known/ucp