Get Hotel Rooms

Get available rooms for a specific hotel. Retrieve detailed room information including types, pricing, capacity, and availability status for a particular property.

GET /v2/merpi/hotels/:hotel_id/rooms

Retrieve all available rooms for a specific hotel, including room types, pricing, capacity, and availability status.

Path Parameters

Parameter	Type	Required	Description
hotel_id	number	Yes	The unique identifier of the hotel

Example Request

GET {{url}}/v2/merpi/hotels/16/rooms

javascript

const hotelId = 16;
const response = await fetch(`{{url}}/v2/merpi/hotels/${hotelId}/rooms`, {
  method: 'GET',
  headers: {
    'X-API-KEY': 'your_api_key_here',
    'TransactionMedium': 'Web'
  }
});
const data = await response.json();

Response

Success Response (200)

{
    "success": true,
    "status": 200,
    "message": "List of rooms",
    "data": {
        "hotel": {
            "id": 16,
            "name": "Grand Paradise Hotel"
        },
        "rooms": [
            {
                "id": 10,
                "hotel_id": 16,
                "number_of_room": "22",
                "room_name": "Basic",
                "type": null,
                "description": null,
                "max_occupancy": 2,
                "price": 26150,
                "is_available": true,
                "images": [
                 {
                        "id": 20,
                        "image_url": "https://dev.syticks.com/storage/HotelPhotos/hdrAuepW4uf8FWqrKRCvJogTgyZcit0DCezy7PWG.jpg",
                        "alt_text": "Room Image"
                    }
                ],
                "created_at": "2025-09-10T01:02:59.000000Z",
                "updated_at": "2025-09-10T01:02:59.000000Z"
            },
            {
                "id": 9,
                "hotel_id": 16,
                "number_of_room": "23",
                "room_name": "Deluxe",
                "type": null,
                "description": null,
                "max_occupancy": 2,
                "price": 38000,
                "is_available": true,
                "images": [
                 {
                        "id": 20,
                        "image_url": "https://dev.syticks.com/storage/RoomPhotos/hdrAuepW4uf8FWqrKRCvJogTgyZcit0DCezy7PWG.jpg",
                        "alt_text": "Room Image"
                    }
                ],
                "created_at": "2025-09-10T00:56:46.000000Z",
                "updated_at": "2025-09-10T00:56:46.000000Z"
            }
        ],
        "next_page": null,
        "count": 2,
        "per_page": 20
    }
}

Response Fields

Hotel Summary

Field	Type	Description
id	number	Hotel identifier
name	string	Hotel name

Room Object

Field	Type	Description
id	number	Unique room identifier (use this for booking)
hotel_id	number	Parent hotel identifier
number_of_rooms	string	Number of rooms available of this type
room_name	string	Room category name (e.g., Basic, Deluxe, Suite)
type	string|null	Additional room type classification
description	string|null	Detailed room description
max_occupancy	number	Maximum number of guests allowed
price	number	Price per night in Naira
is_available	boolean	Current availability status
images	array	Room images with URLs
created_at	string	Record creation timestamp
updated_at	string	Last update timestamp

Important Notes

Availability Check: Always call this endpoint immediately before booking to ensure real-time room availability. The is_available field indicates current status.

Room ID for Booking: Use the id field (not hotel_id) when making a booking request.

Pricing: The price field represents the cost per night. Total booking cost = price × number of nights × number of rooms.

Occupancy: Check max_occupancy to ensure the room can accommodate your guest count.

Integration Flow

// 1. User selects a hotel from the list
const hotels = await getHotels();
const selectedHotelId = hotels.data.hotels[0].id;

// 2. Fetch available rooms for selected hotel
const rooms = await fetch(`/v2/merpi/hotels/${selectedHotelId}/rooms`);
const roomData = await rooms.json();

// 3. Display rooms to user with pricing
roomData.data.rooms.forEach(room => {
  console.log(`${room.room_name}: ₦${room.price}/night`);
  console.log(`Available: ${room.is_available}`);
  console.log(`Max guests: ${room.max_occupancy}`);
});

// 4. User selects room and proceeds to booking
const selectedRoomId = roomData.data.rooms[0].id;
// Proceed to book using this room_id

Next Steps

After retrieving room information:

1. Display available rooms with pricing to your users

2. Allow users to select room type and quantity

3. Proceed to Book Hotel Room to complete the reservation