Get Hotel/Apartment/Resort 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();

Get list of rooms for a single hotel, apartment, or resort

get

Retrieve all available rooms for a specific hotel, apartment, or resort. This endpoint returns detailed room information including room name, description, pricing per night with breakdown, maximum occupancy, images, and real-time availability status. This endpoint is strictly for fetching rooms belonging to a single property.

Path parameters

hotel_idintegerRequired

ID of the hotel, apartment, or resort.

Example: 2

Query parameters

pageintegerOptional

Page number for pagination.

Example: 1

per_pageintegerOptional

Number of rooms per page.

Example: 20

Responses

200

List of rooms for the specified property

application/json

get

/v2/merpi/hotels/{hotel_id}/rooms

HTTPcURLJavaScriptPython

GET /v2/merpi/hotels/{hotel_id}/rooms HTTP/1.1
Accept: */*

200

List of rooms for the specified property

{
  "success": true,
  "status": 200,
  "message": "List of rooms",
  "data": {
    "hotel": {
      "id": 2,
      "name": "Stay IN Apartments, Ikeja"
    },
    "rooms": [
      {
        "id": 4,
        "hotel_id": 2,
        "number_of_rooms": "103",
        "room_name": "Test Room Fixed",
        "type": null,
        "description": "Test room description",
        "max_occupancy": 2,
        "price": 103.5,
        "price_breakdown": {
          "ticket_price": 100,
          "convenience_fee": 2,
          "merchant_commission": 1.5
        },
        "is_available": true,
        "images": [
          {
            "id": 4,
            "image_url": "https://dev.syticks.com/storage/RoomPhotos/2HpFeDR1UI4EfY3jJ04nP3OIjzRKHPkoTPSrZ0ym.png",
            "alt_text": "Room Image"
          },
          {
            "id": 5,
            "image_url": "https://dev.syticks.com/storage/RoomPhotos/GqvEwUyUBmSvkvuf5QJjfR9mRUiYIRlljHexIV7X.png",
            "alt_text": "Room Image"
          }
        ],
        "created_at": "2025-09-07T22:08:47.000000Z",
        "updated_at": "2025-09-07T22:08:47.000000Z"
      }
    ],
    "next_page": null,
    "count": 7,
    "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