This collection provides a comprehensive set of API endpoints for a hotel booking and management system inspired by Airbnb. It covers user authentication, hotel and room management (admin), hotel search and booking (user), and booking lifecycle (initiation, guest addition, payment, cancellation).
\nBase URL :
\nhttp://localhost:8081/api/v1/Authentication :
\nAuthorization header as Bearer .Admin vs User:
\nAdmin endpoints are for hotel managers.
\nuser endpoints are for users.
\nSign Up & Login:
\nSignup and Login endpoints to create an account and obtain a JWT token.Hotel Management (Admin):
\nHotel Search & Booking (User):
\nBooking Workflow:
\nStep 1: Initiate booking
\nStep 2: Add guests
\nStep 3: Make payment
\nOptionally: Cancel booking
\nAdmin: Endpoints for hotel managers (manage hotels and rooms)
\nUser: Endpoints for user authentication, details, and booking
\nBooking: Endpoints for searching, booking, and payment
\nRoom: Endpoints for room management
\nHotel: Endpoints for hotel management
\nAuth: Endpoints for user authentication
\nRefer to each folder and request for detailed documentation, parameters, and example payloads.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Hotel-Booking-System (BookNStay)","slug":"hotel-booking-system-booknstay"}],"owner":"32039601","collectionId":"780004db-9b4b-4e85-979d-b3f52bcf3b9b","publishedId":"2sB3QNqU4G","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-10-16T10:26:51.000Z"},"item":[{"name":"Admin","item":[{"name":"Hotel : Hotel Manager","item":[{"name":"Create Hotel","id":"4fa2893d-0eb6-4894-b867-e428c7039918","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\" : \"Hotel Taj\",\r\n \"city\" : \"Mumbai\",\r\n \"contactInfo\" : {\r\n \"address\" : \"Mumbai\",\r\n \"email\" : \"taj@hotels.com\",\r\n \"phoneNumber\" : \"0000011111\",\r\n \"location\" : \"74.2381, 28.43124\"\r\n },\r\n \"amenities\" : [\"AC\", \"Lake View\", \"Pool Area\"],\r\n \"photos\" : [\"http://via.placeholder.com/50\"]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/api/v1/admin/hotels","urlObject":{"protocol":"http","port":"8081","path":["api","v1","admin","hotels"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"4fa2893d-0eb6-4894-b867-e428c7039918"},{"name":"Get All Hotels","id":"bb94aed6-d4c3-4f38-a46c-60e51855fc41","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\" : \"Hotel Lotus\",\r\n \"city\" : \"Delhi\",\r\n \"contactInfo\" : {\r\n \"address\" : \"Central Delhi\",\r\n \"email\" : \"hello@lotushotels.com\",\r\n \"phoneNumber\" : \"9862345561\",\r\n \"location\" : \"74.2381, 28.43124\"\r\n },\r\n \"amenities\" : [\"AC\", \"Lake View\", \"Pool Area\"],\r\n \"photos\" : [\"http://via.placeholder.com/50\"]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/api/v1/admin/hotels","urlObject":{"protocol":"http","port":"8081","path":["api","v1","admin","hotels"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"bb94aed6-d4c3-4f38-a46c-60e51855fc41"},{"name":"Get Hotel By Id","id":"14c5f83c-3cf7-40a9-b9f5-5463194ff21c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:8081/api/v1/admin/hotels/1","urlObject":{"protocol":"http","port":"8081","path":["api","v1","admin","hotels","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"14c5f83c-3cf7-40a9-b9f5-5463194ff21c"},{"name":"Update Hotel By Id","id":"ae738b51-0b64-4f18-972a-727df0b814d8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\" : \"Hotel Raj\",\r\n \"city\" : \"Gurgaon\",\r\n \"contactInfo\" : {\r\n \"address\" : \"Sector-22A, Gurgaon\",\r\n \"email\" : \"hello@rajhotels.com\",\r\n \"phoneNumber\" : \"9862345561\",\r\n \"location\" : \"74.2381, 28.43124\"\r\n },\r\n \"amenities\" : [\"AC\", \"Lake View\", \"Pool Area\"],\r\n \"photos\" : [\"http://via.placeholder.com/50\"],\r\n \"isActive\" : false\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/api/v1/admin/hotels/1","urlObject":{"protocol":"http","port":"8081","path":["api","v1","admin","hotels","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"ae738b51-0b64-4f18-972a-727df0b814d8"},{"name":"Delete Hotel By Id","id":"f2191558-4d09-491a-a5d4-5fcb8971ad79","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\" : \"Hotel Raj\",\r\n \"city\" : \"Gurgaon\",\r\n \"contactInfo\" : {\r\n \"address\" : \"Sector-22A, Gurgaon\",\r\n \"email\" : \"hello@rajhotels.com\",\r\n \"phoneNumber\" : \"9862345561\",\r\n \"location\" : \"74.2381, 28.43124\"\r\n },\r\n \"amenities\" : [\"AC\", \"Lake View\", \"Pool Area\", \"Cyber City\"],\r\n \"photos\" : [\"http://via.placeholder.com/50\"]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/api/v1/admin/hotels/1","urlObject":{"protocol":"http","port":"8081","path":["api","v1","admin","hotels","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"f2191558-4d09-491a-a5d4-5fcb8971ad79"},{"name":"Activate Hotel By Id","id":"16e38e47-5a26-4931-908f-9d37a1df711a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":""},"url":"http://localhost:8081/api/v1/admin/hotels/1","urlObject":{"protocol":"http","port":"8081","path":["api","v1","admin","hotels","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"16e38e47-5a26-4931-908f-9d37a1df711a"}],"id":"91173a09-02b8-43b6-aca6-167991b69cf3","description":"Hotel endpoints allow admins to manage hotel entities.
\n⭐️ Use these APIs to
\n1. Create Hotels
\n2. Update Hotels
\n3. Activate Hotels
\n4. Retrieve Hotels
\n5. Delete Hotels.
\nAll endpoints require admin authentication via JWT Bearer token.
\n","_postman_id":"91173a09-02b8-43b6-aca6-167991b69cf3"},{"name":"Room : Hotel Manager","item":[{"name":"Create Rooms","id":"bd621866-f013-41cf-8085-8ffcfcce49fe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"type\" : \"Double Room\",\r\n \"basePrice\" : 4000.00,\r\n \"photos\" : [\"http://via.placeholder.com/50\", \"http://via.placeholder.com/150\"],\r\n \"amenities\" : [\"AC\", \"WiFi\", \"Beach View\", \"Mini Bar\"],\r\n \"totalCount\" : \"20\",\r\n \"capacity\" : \"4\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/api/v1/admin/hotels/1/rooms","urlObject":{"protocol":"http","port":"8081","path":["api","v1","admin","hotels","1","rooms"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"bd621866-f013-41cf-8085-8ffcfcce49fe"},{"name":"Get All Rooms","id":"ea02a3e3-3e3b-435e-a3da-5d60f17a85b4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/api/v1/admin/hotels/1/rooms","urlObject":{"protocol":"http","port":"8081","path":["api","v1","admin","hotels","1","rooms"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"ea02a3e3-3e3b-435e-a3da-5d60f17a85b4"},{"name":"Get Rooms By ID","id":"9fe2ef2b-27bb-4874-a556-197989634d05","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":""},"url":"http://localhost:8081/api/v1/admin/hotels/1/rooms/1","urlObject":{"protocol":"http","port":"8081","path":["api","v1","admin","hotels","1","rooms","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"9fe2ef2b-27bb-4874-a556-197989634d05"},{"name":"Update Rooms By Id","id":"a8cf3da8-f1ed-4c2a-b3a6-bb070d0cfda1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"id\" : 2,\r\n \"type\" : \"Single Room\",\r\n \"basePrice\" : 10000.00,\r\n \"photos\" : [\"http://via.placeholder.com/50\", \"http://via.placeholder.com/150\"],\r\n \"amenities\" : [\"AC\", \"WiFi\", \"Beach View\", \"Mini Bar\"],\r\n \"totalCount\" : \"4\",\r\n \"capacity\" : \"2\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/api/v1/admin/hotels/1/rooms/1","urlObject":{"protocol":"http","port":"8081","path":["api","v1","admin","hotels","1","rooms","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"a8cf3da8-f1ed-4c2a-b3a6-bb070d0cfda1"},{"name":"Delete Rooms By ID","id":"f21a02bb-4086-42ff-8fe6-56ee2efd4390","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/api/v1/admin/hotels/1/rooms/1","urlObject":{"protocol":"http","port":"8081","path":["api","v1","admin","hotels","1","rooms","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"f21a02bb-4086-42ff-8fe6-56ee2efd4390"}],"id":"3c813866-47c5-4d87-9614-72295fd7ad08","description":"Room endpoints allow admins to manage rooms within hotels.
\n⭐️ Use these APIs to
\nCreate Rooms
\nUpdate Rooms
\nRetrieve Rooms
\nDelete Rooms
\nAll endpoints require admin authentication via JWT Bearer token.
\n","_postman_id":"3c813866-47c5-4d87-9614-72295fd7ad08"}],"id":"b5ac2ce5-8c2c-4e5a-84e1-00dabddf87c5","description":"Admin endpoints are for hotel managers. These APIs allow admins to manage hotels and rooms, including creating, updating, activating, and deleting hotels and rooms. Use these endpoints to maintain the hotel inventory and room details. Authentication as an admin is required for all endpoints in this folder.
\n","_postman_id":"b5ac2ce5-8c2c-4e5a-84e1-00dabddf87c5"},{"name":"User","item":[{"name":"Auth","item":[{"name":"Signup","id":"515bbbb5-408b-497e-ae91-e3d41afdff29","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"city\" : \"Delhi\",\r\n \"startDate\" : \"2025-06-10\",\r\n \"endDate\" : \"2025-06-20\",\r\n \"roomsCount\" : 2,\r\n \"page\" : 0,\r\n \"size\" : 4\r\n}"},"url":"http://localhost:8081/api/v1/auth/signup","description":"Sign up a new user account.
\nMethod: POST\nEndpoint: /auth/signup
\nRequest Body:
\nusername (string, required): Desired usernameemail (string, required): User email addresspassword (string, required): PasswordExample Payload:
\n{\n \"username\": \"john_doe\",\n \"email\": \"john@example.com\",\n \"password\": \"yourpassword\"\n}\nResponse:
\nAuthentication: Not required
\n","urlObject":{"protocol":"http","port":"8081","path":["api","v1","auth","signup"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"515bbbb5-408b-497e-ae91-e3d41afdff29"},{"name":"Login","id":"675b25b7-fd83-4271-90cc-8f8e681f6f6d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\" : \"example@gmail.com\",\r\n \"password\" : \"example123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/api/v1/auth/login","description":"Authenticate an existing user and obtain a JWT token for accessing protected endpoints.
\nMethod: POST\nEndpoint: /auth/login
\nRequest Body:
\nemail (string, required): User email addresspassword (string, required): PasswordExample Payload:
\n{\n \"email\": \"john@example.com\",\n \"password\": \"yourpassword\"\n}\nResponse:
\nAuthentication: Not required
\n","urlObject":{"protocol":"http","port":"8081","path":["api","v1","auth","login"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"675b25b7-fd83-4271-90cc-8f8e681f6f6d"}],"id":"d479df1a-73be-4c13-b9e9-bdd18cb0bc07","description":"Auth endpoints allow users to sign up and log in to the platform.
\n⭐️ Use these APIs to create a new account or authenticate an existing user.
\n👉 On successful login, a JWT token is provided for accessing protected endpoints.
\n","_postman_id":"d479df1a-73be-4c13-b9e9-bdd18cb0bc07"},{"name":"Details","item":[{"name":"User Details","id":"68f2eb82-73bd-4fcd-a100-fd76b506bd6d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:8081/api/v1/users/10","urlObject":{"protocol":"http","port":"8081","path":["api","v1","users","10"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"68f2eb82-73bd-4fcd-a100-fd76b506bd6d"}],"id":"70a431cb-eb7c-47ed-97ea-3e3b6db1368c","description":"Details folder contains endpoints for retrieving user-specific information, such as user profile details. Authentication is required.
\n","_postman_id":"70a431cb-eb7c-47ed-97ea-3e3b6db1368c"},{"name":"Booking","item":[{"name":"Search Hotel","id":"6f712275-b58c-4385-9132-d9cce400f2cf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"city\" : \"Gurgaon\",\r\n \"startDate\" : \"2025-10-10\",\r\n \"endDate\" : \"2025-10-15\",\r\n \"roomsCount\" : 2,\r\n \"page\" : 0,\r\n \"size\" : 4\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/api/v1/hotels/search","urlObject":{"protocol":"http","port":"8081","path":["api","v1","hotels","search"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"6f712275-b58c-4385-9132-d9cce400f2cf"},{"name":"Hotel Details","id":"45a447d3-5740-45a0-86bf-a40ee5449328","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/api/v1/hotels/1/info","urlObject":{"protocol":"http","port":"8081","path":["api","v1","hotels","1","info"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"45a447d3-5740-45a0-86bf-a40ee5449328"},{"name":"Step-1 : Initiate Booking","id":"6080ef8c-4d13-489b-8fd0-d00f5f8a5f8b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Booking endpoints cover the hotel search and booking workflow for users.
\n⭐️ Use these APIs to
\nSearch for hotels
\nView hotel details
\nInitiate a booking
\nAdd guests
\nMake payments
\nCancel bookings (optional)
\nAuthentication is required for all endpoints in this folder.
\n","_postman_id":"13ea7249-b956-43fd-b260-fd43389d7b35"}],"id":"7195ef99-5068-4565-bcf4-0eee31d84a97","description":"User endpoints are for guests using the platform.
\n⭐️ These APIs allow users to
\nSign Up
\nLog In
\nView their details
\nManage their bookings
\nAuthentication is required for most endpoints in this folder.
\n","_postman_id":"7195ef99-5068-4565-bcf4-0eee31d84a97"}]}