{"info":{"_postman_id":"7f9bc9fd-bcb5-4092-a203-5447850a8eeb","name":"forever","description":"

Forever is a full-stack E-Commerce REST API built to support a modern online shopping platform.

The API includes user authentication, product management, cart functionality, order processing, and payment integrations (Stripe & Razorpay).

It follows a role-based access model with separate user and admin capabilities, ensuring secure and scalable operations.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"39216531","collectionId":"7f9bc9fd-bcb5-4092-a203-5447850a8eeb","publishedId":"2sBXVeFXoG","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-01-08T05:36:58.000Z"},"item":[{"name":"user","item":[{"name":"Register","id":"7fb7d333-3770-442c-9736-e0d73f8d0aff","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"Test User\",\r\n \"email\": \"test@example.com\",\r\n \"password\": \"password123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://ecommerce-app-axjc.onrender.com/api/user/register","description":"

This API is used to register a new user in the system.

It accepts basic user details like name, email, and password.

After successful registration, a JWT token is generated and returned, which can be used for authenticated requests.

\n","urlObject":{"protocol":"https","path":["api","user","register"],"host":["ecommerce-app-axjc","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"7fb7d333-3770-442c-9736-e0d73f8d0aff"},{"name":"login","id":"0e416fbb-5955-463f-8826-b6a22e7a2910","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"test@example.com\",\r\n \"password\": \"password123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://ecommerce-app-axjc.onrender.com/api/user/login","description":"

This API allows an existing user to log in using email and password.

On successful authentication, a JWT token is returned.

This token must be sent in protected APIs to access user-specific resources.

\n","urlObject":{"protocol":"https","path":["api","user","login"],"host":["ecommerce-app-axjc","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"0e416fbb-5955-463f-8826-b6a22e7a2910"},{"name":"product list","id":"bcd93dec-4aea-48d0-a564-7365797995cf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://ecommerce-app-axjc.onrender.com/api/product/list","urlObject":{"protocol":"https","path":["api","product","list"],"host":["ecommerce-app-axjc","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"bcd93dec-4aea-48d0-a564-7365797995cf"},{"name":"cart data","id":"d8d39e93-8441-4996-844d-44ec078255ef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://ecommerce-app-axjc.onrender.com/api/cart/get","description":"

This API retrieves the logged-in user's cart data.

It returns product IDs with selected sizes and quantities.

Requires a valid user token.

\n","urlObject":{"protocol":"https","path":["api","cart","get"],"host":["ecommerce-app-axjc","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"d8d39e93-8441-4996-844d-44ec078255ef"},{"name":"order","id":"948f6636-1677-42c5-81f7-e876c07a2332","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"items\": [\r\n {\r\n \"productId\": \"PROD001\",\r\n \"name\": \"T-Shirt\",\r\n \"quantity\": 2,\r\n \"price\": 499\r\n },\r\n {\r\n \"productId\": \"PROD002\",\r\n \"name\": \"Jeans\",\r\n \"quantity\": 1,\r\n \"price\": 1299\r\n }\r\n ],\r\n \"amount\": 3000,\r\n \"address\": {\r\n \"name\": \"Kiran Dekaliya\",\r\n \"phone\": \"9999999999\",\r\n \"street\": \"Main Road\",\r\n \"city\": \"Ahmedabad\",\r\n \"state\": \"Gujarat\",\r\n \"pincode\": \"380001\"\r\n },\r\n \"paymentMethod\": \"COD\",\r\n \"payment\": false,\r\n \"date\": 1735641600000\r\n}\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"https://ecommerce-app-axjc.onrender.com/api/order/place","description":"

This API places an order using Cash on Delivery (COD) payment method.

It accepts cart items, total amount, and delivery address details.

Requires user authentication.

\n","urlObject":{"protocol":"https","path":["api","order","place"],"host":["ecommerce-app-axjc","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"948f6636-1677-42c5-81f7-e876c07a2332"},{"name":"userorder","id":"2ca9cf8b-b217-4a0a-9e7c-a82dffbc6655","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://ecommerce-app-axjc.onrender.com/api/order/userorders","description":"

This API fetches all orders placed by the logged-in user.

It includes order details, payment status, delivery address, and order status.

Requires user authentication.

\n","urlObject":{"protocol":"https","path":["api","order","userorders"],"host":["ecommerce-app-axjc","onrender","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"2ca9cf8b-b217-4a0a-9e7c-a82dffbc6655"},{"name":"stripe","id":"3deee182-f8f6-4555-b6a2-e5fbaccd94e1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"items\": [\r\n {\r\n \"productId\": \"PROD001\",\r\n \"name\": \"T-Shirt\",\r\n \"quantity\": 2,\r\n \"price\": 499\r\n },\r\n {\r\n \"productId\": \"PROD002\",\r\n \"name\": \"Jeans\",\r\n \"quantity\": 1,\r\n \"price\": 1299\r\n }\r\n ],\r\n \"amount\": 3000,\r\n \"address\": {\r\n \"name\": \"Kiran Dekaliya\",\r\n \"phone\": \"9999999999\",\r\n \"street\": \"Main Road\",\r\n \"city\": \"Ahmedabad\",\r\n \"state\": \"Gujarat\",\r\n \"pincode\": \"380001\"\r\n },\r\n \"paymentMethod\": \"COD\",\r\n \"payment\": false,\r\n \"date\": 1735641600000\r\n}\r\n\r\n","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/api/order/stripe","description":"

This API initiates a Stripe payment session for online payment.

It creates a secure Stripe checkout session and returns a session URL.

The user is redirected to Stripe for payment completion.

\n","urlObject":{"protocol":"http","port":"4000","path":["api","order","stripe"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"3deee182-f8f6-4555-b6a2-e5fbaccd94e1"}],"id":"dd323c91-bb6d-4c3e-851d-f7f2d2b3df5e","description":"

\n

The User APIs handle all customer-side functionalities of the Forever platform.

These APIs allow users to register, log in, browse products, manage their cart, place orders, and make online payments.

User authentication is managed using JWT tokens, which are required for accessing protected user routes.

User Capabilities:

Register and login securely
\n
View product listings and product details
\n
Add, update, and view cart items
\n
Place orders using COD, Stripe, or Razorpay
\n
View their order history and payment status
\n

\n","_postman_id":"dd323c91-bb6d-4c3e-851d-f7f2d2b3df5e"},{"name":"admin","item":[{"name":"admin","id":"e1ccf13f-a330-4d86-a7d4-8ca6e1392b07","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"admin@forever.com\",\r\n \"password\": \"qwerty123\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/api/user/admin","description":"

This API is used for admin authentication.

Admin credentials are validated using environment variables for security.

On successful login, an admin JWT token is returned, which is required to access admin-only APIs.

\n","urlObject":{"protocol":"http","port":"4000","path":["api","user","admin"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"e1ccf13f-a330-4d86-a7d4-8ca6e1392b07"},{"name":"list","id":"cc37f7c8-f1dd-4768-a027-7b989f5dab63","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"name","type":"text","uuid":"e4aabb7d-b12c-42c4-9285-ffb4a0a998cb","value":"kiran"},{"key":"description","value":"testing","type":"text","uuid":"fe186584-61c2-47d8-b0a2-5be960882c81"},{"key":"price","value":"10","type":"text","uuid":"12743a0c-b009-4e29-8913-c88b145c06f0"},{"key":"bestseller ","value":"true","type":"text","uuid":"b40735bb-d110-45ae-8098-1739b38ea4e2"},{"key":"category","value":"women","type":"text","uuid":"d4f39148-3948-42b5-bd64-cab1f1f5f223"},{"key":"subCategory","value":"topwear","type":"text","uuid":"12595aba-c47d-499b-9335-39d848519476"},{"key":"sizes","value":"[\"M\"]","type":"text","uuid":"87bb3503-d450-4ee9-ae30-98039ffc2cac"},{"key":"image1","type":"file","uuid":"32e65ad3-d646-4ef0-82d2-d54fd4217f41","src":"/D:/Ecommerce-app/frotend/src/assets/women.png"},{"key":"image2","type":"file","uuid":"3ed23c48-b28d-4151-9b2c-11f5ed2e456e","src":"/D:/Ecommerce-app/frotend/src/assets/women1.png"},{"key":"image3","type":"file","uuid":"3c364cf6-b014-4df0-b2da-1b28611aa5e6","src":"/D:/Ecommerce-app/frotend/src/assets/women.png"},{"key":"image4","type":"file","uuid":"26fcd62d-a17b-4fb2-aeff-e9c721878e2b","src":"/D:/Ecommerce-app/frotend/src/assets/women1.png"}]},"url":"http://localhost:4000/api/product/list","description":"

This API fetches all available products from the database.

It is a public API and does not require authentication.

Used on the home page and product listing pages.

\n","urlObject":{"protocol":"http","port":"4000","path":["api","product","list"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"cc37f7c8-f1dd-4768-a027-7b989f5dab63"},{"name":"admin order status","id":"862817ba-c410-4b8f-b88d-453c841827b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6ImFkbWluQGZvcmV2ZXIuY29tIiwiaWF0IjoxNzY3ODUwMjgxLCJleHAiOjE3Njg0NTUwODF9.6HD6cupLUMYKdq_ultQ2Eg7JIJyMyw57GuLZ_fs8LKs","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"orderId\": \"69578ea6e8aece8c8368f69c\",\r\n \"status\": \"Shipped\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:4000/api/order/status","description":"

This admin-only API updates the delivery status of an order (e.g., Shipped, Delivered).

Used by admin to manage order lifecycle.

Requires admin authentication.

\n","urlObject":{"protocol":"http","port":"4000","path":["api","order","status"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"862817ba-c410-4b8f-b88d-453c841827b7"}],"id":"5c68387d-e586-4932-9efc-ba296f444d9e","description":"

\n

The Admin APIs are designed for platform management and control.

These APIs allow administrators to manage products, monitor orders, and update order delivery statuses.

Admin authentication is handled separately using environment-based credentials to ensure higher security.

Admin Capabilities:

Secure admin login
\n
Add and remove products
\n
View all orders placed on the platform
\n
Update order status (Packing, Shipped, Delivered, etc.)
\n
Manage overall store operations
\n

\n","_postman_id":"5c68387d-e586-4932-9efc-ba296f444d9e"}]}