MERN Auction Platform is a dynamic online bidding system built with MongoDB, Express.js, React, and Node.js (MERN Stack). It provides a secure and transparent environment where users can participate in live auctions seamlessly.
\nπΉ Create auctions for products/services with details like starting price, bid increments, and duration.
πΉ Edit or delete auctions before bidding begins.
πΉ Monitor live bidding activity and auction progress.
πΉ Browse active auctions and place competitive bids.
πΉ Engage in real-time bidding against other users.
πΉ Win auctions and view bid history in the dashboard.
πΉ Manage the platform, oversee users & control auctions.
πΉ Ban, approve, or remove users if needed.
πΉ Monitor bidding activities to ensure fair play.
β
Real-time Bidding π₯ β Live updates for ongoing auctions.
β
Secure Authentication π β Role-based access with JWT.
β
Transaction History π β Auctioneers & Bidders can track their activity.
β
Email Notifications π© β Alerts for bids, wins & updates.
β
User-friendly Dashboard π₯οΈ β Easy navigation for all users.
The MERN Auction Platform ensures a fair, engaging, and efficient bidding experience for all users, making online auctions more interactive than ever! ππ₯
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"39190423","collectionId":"cb912ca1-c109-4b0b-adb0-7ddc80ee780f","publishedId":"2sAYdeKrLc","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-02-24T20:15:27.000Z"},"item":[{"name":"USER ROUTES","item":[{"name":"REGISTER","id":"45c8e462-4a79-4f3d-9155-423623f20211","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"userName","value":"Jeevan Kadam","type":"text","uuid":"83c3cb14-a170-4f51-b018-dc712ac3b650"},{"key":"email","value":"jeevan123@gmail.com","type":"text","uuid":"2af90251-4ed0-4d73-bd64-5cc75a55b7e1"},{"key":"Phone","value":"9021557571","type":"text","uuid":"bde37b3b-6c16-4172-9929-185c2dd0db12"},{"key":"password","value":"1234568","type":"text","uuid":"ff2c425a-fa9c-4ffe-b9eb-8fc6ac9b8dd4"},{"key":"role","value":"Auctioner","type":"text","uuid":"903b8411-0d7c-40a5-a563-3ca1be1a37ab"},{"key":"address","value":"Gujrat","type":"text","uuid":"28a55d01-057b-4b24-b581-e64989213247"},{"key":"bankAccountNumber","value":"cnrbbanknarayangaon0335266325566","type":"text","uuid":"4bb15e8f-6f05-4638-b87b-f5b13510cd0e"},{"key":"bankAccountName","value":"Jeevan Kadam","type":"text","uuid":"e34dd0b4-d5d4-479f-b387-c2ba0901beec"},{"key":"bankName","value":"Canara Bank","type":"text","uuid":"b931d9c2-607b-4a3a-b823-83802a3323cc"},{"key":"easypaisaAccountNumber","value":"03356932","type":"text","uuid":"fe04beb2-64f7-4237-bc3a-307f7d11df08"},{"key":"paypalEmail","value":"jeevan123@gmail.com","type":"text","uuid":"d1b39ac9-90a2-4579-9982-ac9652f38028"},{"key":"profileImage","type":"file","uuid":"bf209690-7f94-43d6-b78c-05ae9ff65201","src":"/C:/Users/jeevan/Pictures/Saved Pictures/bonafide.jpg"}]},"url":"http://localhost:5000/api/v1/user/register","description":"π Endpoint:http://localhost:5000/api/v1/user/register
π Description:
Allows new users (Auctioneer or Bidder) to create an account. Requires details like name, email, password, and role.
π Response:
β
Success: Returns user data and authentication token.
β Error: Email already exists or validation fails.
π Endpoint:http://localhost:5000/api/v1/user/login
π Description:
Authenticates a user and provides a JWT token for secure access.
π Response:
β
Success: Returns JWT token and user details.
β Error: Incorrect email or password
π Endpoint:http://localhost:5000/api/v1/user/leaderboard
π Description:
Retrieves the top bidders or auctioneers based on auction activity.
π Response Example:
\njsonCopyEdit[\n {\n \"rank\": 1,\n \"user\": \"Alice\",\n \"bidsPlaced\": 50\n },\n {\n \"rank\": 2,\n \"user\": \"Bob\",\n \"bidsPlaced\": 45\n }\n]\n\nStartFragment
\nπ Endpoint:http://localhost:5000/api/v1/user/me
π Description:
Retrieves the authenticated userβs profile details.
π Headers Required:
\njsonCopyEdit{\n \"Authorization\": \"Bearer your_jwt_token\"\n}\n\nπ Response Example:
\njsonCopyEdit{\n \"id\": \"12345\",\n \"name\": \"John Doe\",\n \"email\": \"johndoe@example.com\",\n \"role\": \"bidder\",\n \"auctionsWon\": 3\n\nEndFragment
\n","urlObject":{"protocol":"http","port":"5000","path":["api","v1","user","me"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"b53982b8-06cd-40af-860e-7adb2772e8fe"},{"name":"LOGOUT","id":"5843dfff-710f-4574-bbd2-0958a6087dba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"description":"StartFragment
\nπ Endpoint:http://localhost:5000/api/v1/user/logout
π Description:
Logs out the user by clearing the session/token from storage.
π Response:
β
Success: \"message\": \"Logged out successfully\"
β Error: User not authenticated.
EndFragment
\n","urlObject":{"query":[],"variable":[]},"url":""},"response":[],"_postman_id":"5843dfff-710f-4574-bbd2-0958a6087dba"}],"id":"600f39dc-3763-4ce6-b60f-28d4ba201739","description":"These API endpoints handle user authentication, profile management, and leaderboard fetching.
\n","_postman_id":"600f39dc-3763-4ce6-b60f-28d4ba201739"},{"name":"AUCTION ROUTES","item":[{"name":"ADD NEW AUCTION ITEM","id":"588a33bf-4b61-4ffe-8cb0-83871a68e7a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"description":"π Endpoint:POST http://localhost:5000/api/v1/auctionitem/add
π Description:
Allows an Auctioneer to create a new auction item.
π Request Body (JSON Example):
\njsonCopyEdit{\n \"title\": \"Luxury Watch\",\n \"description\": \"A high-end Rolex watch in mint condition.\",\n \"startingPrice\": 5000,\n \"bidIncrement\": 200,\n \"endTime\": \"2025-03-15T20:00:00.000Z\",\n \"image\": \"watch-image-url\"\n}\n\nπ Response Example:
\njsonCopyEdit{\n \"message\": \"Auction item added successfully\",\n \"auctionItem\": {\n \"id\": \"67b0e4910f6520ec8ed59307\",\n \"title\": \"Luxury Watch\",\n \"startingPrice\": 5000,\n \"status\": \"active\"\n }\n}\n\nβ
Success: Auction item added.
β Error: Invalid data or unauthorized access.
π Endpoint:GET http://localhost:5000/api/v1/auctionitem/all
π Description:
Retrieves a list of all active auction items available for bidding.
π Response Example:
\njsonCopyEdit[\n {\n \"id\": \"67b0e4910f6520ec8ed59307\",\n \"title\": \"Luxury Watch\",\n \"startingPrice\": 5000,\n \"currentBid\": 5200,\n \"endTime\": \"2025-03-15T20:00:00.000Z\",\n \"status\": \"active\"\n },\n {\n \"id\": \"67b0e4910f6520ec8ed59308\",\n \"title\": \"MacBook Pro\",\n \"startingPrice\": 1200,\n \"currentBid\": 1400,\n \"endTime\": \"2025-03-18T18:00:00.000Z\",\n \"status\": \"active\"\n }\n]\n\nβ
Success: Returns all auction items.
β Error: No active auctions found.
π Endpoint:GET http://localhost:5000/api/v1/auctionitem/:id
π Description:
Fetches details about a specific auction item including its current status, bids, and auctioneer details.
π Response Example:
\njsonCopyEdit{\n \"id\": \"67b0e4910f6520ec8ed59307\",\n \"title\": \"Luxury Watch\",\n \"description\": \"A high-end Rolex watch in mint condition.\",\n \"startingPrice\": 5000,\n \"currentBid\": 5200,\n \"bids\": [\n { \"bidder\": \"Alice\", \"amount\": 5100 },\n { \"bidder\": \"Bob\", \"amount\": 5200 }\n ],\n \"status\": \"active\"\n}\n\nβ
Success: Returns auction item details.
β Error: Auction item not found.
π Endpoint:GET http://localhost:5000/api/v1/auctionitem/myitems
π Description:
Retrieves a list of all auctions created by the logged-in Auctioneer.
π Response Example:
\njsonCopyEdit[\n {\n \"id\": \"67b0e4910f6520ec8ed59307\",\n \"title\": \"Luxury Watch\",\n \"startingPrice\": 5000,\n \"currentBid\": 5200,\n \"status\": \"active\"\n },\n {\n \"id\": \"67b0e4910f6520ec8ed59309\",\n \"title\": \"Gaming Laptop\",\n \"startingPrice\": 1500,\n \"currentBid\": 1800,\n \"status\": \"sold\"\n }\n]\n\nβ
Success: Returns auctioneerβs auction items.
β Error: No auctions found.
π Endpoint:DELETE http://localhost:5000/api/v1/auctionitem/:id
π Description:
Allows an Auctioneer to delete an auction (only if bidding has not started).
π Response Example:
\njsonCopyEdit{\n \"message\": \"Auction item deleted successfully\"\n}\n\nβ
Success: Auction item removed.
β Error: Item already has bids or unauthorized access.
EndFragment
\n","urlObject":{"query":[],"variable":[]},"url":""},"response":[],"_postman_id":"e81596e3-70c1-4e47-b132-5255c744280a"},{"name":"REPUBLISH ITEM","id":"fb51cdd8-70ff-425a-966d-66fee84c80e6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/v1/auctionitem/item/republish/67b0e4910f6520ec8ed59307","description":"StartFragment
\nπ Endpoint:PUT http://localhost:5000/api/v1/auctionitem/item/republish/67b0e4910f6520ec8ed59307
π Description:
Allows an Auctioneer to republish an auction item that was previously closed or unsold.
π Response Example:
\njsonCopyEdit{\n \"message\": \"Auction item republished successfully\",\n \"auctionItem\": {\n \"id\": \"67b0e4910f6520ec8ed59307\",\n \"status\": \"active\"\n }\n}\n\nβ
Success: Auction item is live again.
β Error: Item is already active or unauthorized action.
EndFragment
\n","urlObject":{"protocol":"http","port":"5000","path":["api","v1","auctionitem","item","republish","67b0e4910f6520ec8ed59307"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"fb51cdd8-70ff-425a-966d-66fee84c80e6"}],"id":"7f152a6c-f226-49a8-8626-f202ef9575af","description":"These API endpoints allow Auctioneers to manage auctions and Bidders to view and participate in live auctions. ππ₯
\n","_postman_id":"7f152a6c-f226-49a8-8626-f202ef9575af"},{"name":"BID ROUTES","item":[{"name":"PLACE BID","id":"d6332c90-44fa-4d88-9900-827be599a006","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"amount","value":"16001","type":"text","uuid":"d67ff8dd-7819-4162-871c-f8cebf401495"}]},"url":"http://localhost:5000/api/v1/bid/place/67b1cf8a7dea39414602b10a","description":"StartFragment
\nπ Endpoint:POST http://localhost:5000/api/v1/bid/place/67b1cf8a7dea39414602b10a
π Description:
Allows a Bidder to place a bid on an active auction item.
π Request Body (Example):
\njsonCopyEdit{\n \"amount\": 5300\n}\n\nπ Response Example:
\njsonCopyEdit{\n \"message\": \"Bid placed successfully\",\n \"auctionItem\": {\n \"id\": \"67b1cf8a7dea39414602b10a\",\n \"currentBid\": 5300,\n \"bidder\": \"John Doe\",\n \"status\": \"active\"\n }\n}\n\nβ
Success: Bid successfully placed.
β Error: Bid amount is too low, auction is closed, or unauthorized access.
EndFragment
\n","urlObject":{"protocol":"http","port":"5000","path":["api","v1","bid","place","67b1cf8a7dea39414602b10a"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"d6332c90-44fa-4d88-9900-827be599a006"}],"id":"53d5d8f2-9243-4cfb-975d-da77d4a6f8bb","description":"StartFragment
\nThese API endpoints allow Bidders to place bids on auction items and track their bidding history. ππ₯
\nEndFragment
\n","_postman_id":"53d5d8f2-9243-4cfb-975d-da77d4a6f8bb"},{"name":"COMMISSION ROUTES","item":[{"name":"POST COMMISSION","id":"511aa1b7-3b96-49d1-822b-2e36b3795d53","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"proof","type":"file","uuid":"727efeb3-c22b-4a6f-b53c-013e29dfc936","src":"/C:/Users/jeevan/Downloads/thread-199855407-12360691436464632027.png"},{"key":"amount","value":"300","type":"text","uuid":"a0a2c684-cd87-44d5-91fa-c2367e0809ef"},{"key":"comment","value":"i am paying my commission via phonepay","type":"text","uuid":"174109ff-973f-48ad-8e68-504397ead5b1"}]},"url":"http://localhost:5000/api/v1/commission/proof","description":"StartFragment
\nπ Endpoint:POST http://localhost:5000/api/v1/commission/add
π Description:
Allows the Super Admin to set or update the platform commission percentage.
β
Success: Commission rate set or updated.
β Error: Unauthorized access or invalid commission rate.
StartFragment
\nThese API endpoints handle commission management for the platform, ensuring that a percentage of each successful bid goes to the platform as commission. ππΌ
\nEndFragment
\n","_postman_id":"e6e448dc-1d9c-4466-b20e-2760aaf44730"},{"name":"SUPER ADMIN ROUTES","item":[{"name":"DELETE AUCTION ITEM","id":"37b858c6-37c7-4a5b-997b-5e216fddeee0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"http://localhost:5000/api/v1/superadmin/delete/","description":"π Endpoint:DELETE http://localhost:5000/api/v1/superadmin/auctionitem/:id
π Description:
Allows the Super Admin to delete any auction item from the platform.
π Response Example:
\njsonCopyEdit{\n \"message\": \"Auction item deleted successfully\"\n}\n\nβ
Success: Auction item removed.
β Error: Auction item not found or unauthorized access.
π Endpoint:GET http://localhost:5000/api/v1/superadmin/paymentproofs
π Description:
Retrieves all submitted payment proofs for auction transactions.
π Response Example:
\njsonCopyEdit[\n {\n \"id\": \"67b2cf8a7dea39414602b10a\",\n \"bidder\": \"John Doe\",\n \"amount\": 5000,\n \"status\": \"Pending\"\n },\n {\n \"id\": \"67b2cf8a7dea39414602b10b\",\n \"bidder\": \"Alice\",\n \"amount\": 7000,\n \"status\": \"Approved\"\n }\n]\n\nβ
Success: Returns all payment proofs.
β Error: No payment proofs found.
π Endpoint:GET http://localhost:5000/api/v1/superadmin/paymentproof/:id
π Description:
Fetches details of a specific payment proof submitted by a bidder.
π Response Example:
\njsonCopyEdit{\n \"id\": \"67b2cf8a7dea39414602b10a\",\n \"bidder\": \"John Doe\",\n \"amount\": 5000,\n \"status\": \"Pending\",\n \"proofImage\": \"payment-proof-url\"\n}\n\nβ
Success: Returns payment proof details.
β Error: Payment proof not found.
π Endpoint:PUT http://localhost:5000/api/v1/superadmin/paymentproof/:id
π Description:
Allows the Super Admin to update the status of a submitted payment proof (e.g., Approved, Rejected).
π Request Body (Example):
\njsonCopyEdit{\n \"status\": \"Approved\"\n}\n\nπ Response Example:
\njsonCopyEdit{\n \"message\": \"Payment proof updated successfully\",\n \"status\": \"Approved\"\n}\n\nβ
Success: Payment proof updated.
β Error: Invalid status or unauthorized access.
π Endpoint:DELETE http://localhost:5000/api/v1/superadmin/paymentproof/:id
π Description:
Allows the Super Admin to delete a fraudulent or invalid payment proof from the system.
π Response Example:
\njsonCopyEdit{\n \"message\": \"Payment proof deleted successfully\"\n}\n\nβ
Success: Payment proof removed.
β Error: Payment proof not found.
π Endpoint:GET http://localhost:5000/api/v1/superadmin/users?role=bidder
π Description:
Retrieves filtered users based on roles (Auctioneer, Bidder, Admin).
π Response Example:
\njsonCopyEdit[\n {\n \"id\": \"67b3df8a7dea39414602b10c\",\n \"name\": \"John Doe\",\n \"role\": \"Bidder\",\n \"status\": \"Active\"\n },\n {\n \"id\": \"67b3df8a7dea39414602b10d\",\n \"name\": \"Alice\",\n \"role\": \"Auctioneer\",\n \"status\": \"Banned\"\n }\n]\n\nβ
Success: Returns filtered users.
β Error: No users found.
π Endpoint:GET http://localhost:5000/api/v1/superadmin/revenue/monthly
π Description:
Retrieves the total revenue earned by the platform from auction commissions for the current month.
π Response Example:
\njsonCopyEdit{\n \"month\": \"February 2025\",\n \"totalRevenue\": 25000\n}\n\nβ
Success: Returns monthly revenue.
β Error: Revenue data not available.
These API endpoints allow the Super Admin to manage auctions, users, and payments, ensuring smooth platform operations. ππ
\n","_postman_id":"1582f6e0-cd51-4e5c-9a2f-715f22d3ac0a"}]}