📦 MyBillBook API Reference

ASP.NET MVC 4.8  ·  Session-Based Auth  ·  SQL Server

http://localhost:PORT/
👤 Auth — /api/auth/
POST api/auth/register Create new account
Body (form-data)
KeyType
namestringrequired
emailstringrequired
phonestringrequired
passwordstringrequired
Response
{"success":true,"message":"Registration successful","data":{"userId":1,"otp":"123456"}}
POST api/auth/verify-otp Verify OTP
Body (form-data)
KeyType
emailstringrequired
otpstringrequired
POST api/auth/login Login and create session
Body (form-data)
KeyType
emailstringrequired
passwordstringrequired
Response
{"success":true,"data":{"user":{"id":1,"name":"Rahul","role":"retailer"},"sessionId":"uuid"}}
POST api/auth/logout End session 🔒
Body (form-data)
session_idstringoptional
GET api/auth/me View your profile 🔒
{"success":true,"data":{"id":1,"name":"Rahul","email":"r@r.com","role":"retailer","isVerified":true}}
GET api/auth/addresses Delivery addresses 🔒
{"success":true,"data":[{"id":1,"label":"Home","fullAddress":"...","city":"Delhi"}]}
POST api/auth/addresses/add Add new address 🔒
labelstringoptional (Home/Office)
full_addressstringrequired
citystringoptional
statestringoptional
pincodestringoptional
is_defaulttrue/falseoptional
POST api/auth/addresses/delete/{id} Delete address 🔒
POST api/auth/addresses/delete/3
GET api/auth/users All users Admin
Query Params
statusactive/inactive/bannedoptional
pagenumberdefault: 1
page_sizenumberdefault: 20
POST api/auth/users/{id}/status Change user status Admin
statusactive/inactive/bannedrequired
📦 Products — /api/product/
GET api/product/categories All categories
statusactive/inactivedefault: active
GET api/product/categories/{id} Single category detail
GET api/product/categories/3
POST api/product/categories/create Create category Admin
namestringrequired
display_ordernumberoptional
statusactive/inactivedefault: active
POST api/product/categories/{id}/update Update category Admin
POST api/product/categories/3/update
POST api/product/categories/{id}/delete Delete category Admin
POST api/product/categories/3/delete
GET api/product/subcategories Sub-categories
category_idnumberoptional filter
GET api/product/list Products list (paginated)
category_idnumberoptional
subcategory_idnumberoptional
searchstringoptional
statusactive/inactivedefault: active
pagenumberdefault: 1
page_sizenumberdefault: 20
Response
{"success":true,"data":{"items":[...],"totalCount":48,"page":1,"pageSize":20,"totalPages":3}}
GET api/product/{id} Single product detail
GET api/product/7
POST api/product/create Create product Admin
category_idnumberrequired
namestringrequired
unit_typekg/litter/packet/piecerequired
price_per_unitdecimalrequired
subcategory_idnumberoptional
descriptionstringoptional
per_packet_weightdecimaloptional
weight_unitkg/litteroptional
min_order_qtynumberdefault: 1
POST api/product/{id}/update Update product Admin
POST api/product/7/update
POST api/product/{id}/delete Delete product Admin
POST api/product/7/delete
🛒 Orders — /api/order/
GET api/order/cart View cart 🔒 Retailer
{"success":true,"data":{"items":[...],"totalAmount":450.00,"itemCount":2}}
POST api/order/cart/add Add item to cart 🔒 Retailer
product_idnumberrequired
quantitynumberrequired
POST api/order/cart/{id}/update Update cart item 🔒 Retailer
POST api/order/cart/3/update
quantitynumberrequired
POST api/order/cart/{id}/remove Remove item 🔒 Retailer
POST api/order/cart/3/remove
POST api/order/place Place order 🔒 Retailer
retailer_idnumberrequired
address_idnumberrequired
Response
{"success":true,"message":"Order placed successfully","data":{"orderId":101}}
GET api/order/my-orders My orders 🔒 Retailer
order_statuspending/accepted/...optional
from_datedateoptional
to_datedateoptional
pagenumberdefault: 1
GET api/order/{id} Order detail with tracking 🔒
GET api/order/101
{"success":true,"data":{"order":{...},"items":[...],"delivery":{...},"tracking":[...]}}
POST api/order/{id}/cancel Cancel order 🔒
POST api/order/101/cancel
reasonstringrequired
GET api/order/all All orders Admin
order_statusstringoptional
from_date / to_datedateoptional
POST api/order/{id}/status Update order status Admin
order_statuspending/accepted/processing/dispatched/delivered/cancelledrequired
admin_notesstringoptional
POST api/order/delivery/assign Assign delivery Admin
order_idnumberrequired
delivery_personstringoptional
phonestringoptional
expected_datedaterequired
tracking_numberstringoptional
POST api/order/tracking/add Add tracking update Admin
order_idnumberrequired
statusOrder Placed/In Transit/Delivered/...required
locationstringoptional
descriptionstringoptional
📊 Stock — /api/stock/
GET api/stock/list All products stock Admin
statusin_stock/low_stock/out_of_stockoptional
category_idnumberoptional
GET api/stock/alerts Low / Out of stock alerts Admin
{"success":true,"data":{"items":[...],"count":5}}
GET api/stock/{productId} Single product stock Admin
GET api/stock/7
POST api/stock/add Add stock Admin
product_idnumberrequired
quantitynumberrequired
reasonstringoptional
POST api/stock/adjust Adjust stock +/- Admin
product_idnumberrequired
quantitynumber (negative for deduction)required
reasonstringrequired
GET api/stock/history Stock history Admin
product_idnumberoptional filter
page / page_sizenumberoptional