# Room-Type API

The **Hotel Room Type API** provides detailed pricing for every room category available in a specific hotel through a simple GET request to `https://api.makcorps.com/roomtype`.

It returns structured data, including room names, prices, taxes, and vendor information — making it easy to compare rates across multiple booking sources.

This endpoint is ideal for building price-comparison tools, travel dashboards, or hotel analytics platforms that require granular, room-level pricing insights.

### Parameters

| Parameter                                                       | Description                                                                                             |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| <p>api\_key<br><br><mark style="color:red;">required</mark></p> | Your personal API key.                                                                                  |
| <p>hotelid<br><br><mark style="color:red;">required</mark></p>  | ID of the hotel. [Contact](https://share.hsforms.com/1A-iwjye2SwWRv4VHhQbBqg439wf) us to get this data. |
| <p>rooms<br><br><mark style="color:red;">required</mark></p>    | It is the number of rooms.                                                                              |
| <p>adults<br><br><mark style="color:red;">required</mark></p>   | It is the number of adults.                                                                             |
| <p>checkin<br><br><mark style="color:red;">required</mark></p>  | <p>It is the check-in date.<br><br>Format - YYYY-MM-DD</p>                                              |
| <p>checkout<br><br><mark style="color:red;">required</mark></p> | <p>It is the check-out date.<br><br>Format - YYYY-MM-DD</p>                                             |

### API Example

### API Example

{% tabs %}
{% tab title="cURL" %}

```bash
curl -X GET "https://api.makcorps.com/roomtype?hotelid=900265&adults=2&rooms=1&checkin=2025-10-18&checkout=2025-10-19&api_key=2347923r8hf98h3489943"
```

{% endtab %}

{% tab title="Python" %}

```python
import requests

url = "https://api.makcorps.com/roomtype"
params = {
    "hotelid": "900265",
    "adults": 2,
    "rooms": 1,
    "checkin": "2025-10-18",
    "checkout": "2025-10-19",
    "api_key": "2347923r8hf98h3489943"
}

response = requests.get(url, params=params)
print(response.json())
```

{% endtab %}

{% tab title="Nodejs" %}

```javascript
import axios from "axios";

const url = "https://api.makcorps.com/roomtype";

const params = {
  hotelid: "900265",
  adults: 2,
  rooms: 1,
  checkin: "2025-10-18",
  checkout: "2025-10-19",
  api_key: "2347923r8hf98h3489943"
};

axios.get(url, { params })
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error);
  });

```

{% endtab %}
{% endtabs %}

### Response

The sample response of the API will look somewhat like this.

```json
[
    {
        "localizedDescription": "Queen Room - Non-refundable",
        "bookingOptions": [
            {
                "price": {
                    "price": 756,
                    "currency": "USD",
                    "localizedPrice": "$756"
                },
                "rateType": "bestAvailable",
                "totalPrice": {
                    "price": 756,
                    "currency": "USD",
                    "localizedPrice": "$756"
                },
                "localizedProviderName": "Booking.com",
                "providerCode": "BOOKINGDOTCOM",
                "logo": "http://content.r9cdn.net/rimg/provider-logos/hotels/h/BOOKINGDOTCOM.png?crop=false&width=166&height=62&fallback=default2.png&_v=1233faf051a0a6b9d9807846b1316f74",
                "bookingId": "1bf3361a59674caf2241ca18ba08e68e",
                "freebies": [],
                "bedCounts": {
                    "queen": 1
                },
                "bookingUrl": "/book/hotel?code=vLAkOGif5s.qumWFano8BP274JKcE0diPaeNWhRPjM7r__yfHjaxxI.87044.900265.MTc2MzQ0MjAwMDAwMF4xNzYzNTI4NDAwMDAwXjFeMl4=&h=9c52bbd05312&sub=0&_sid_=R-4vx5D0Er1WMcOmnMykVoi-HXBZ2RHy_p4hwFwYcof61EvYJuOEBmXPl9bEZVpcK&cookieOverrides=x06b3gGbCKIdLNRjjfxr1aEQDUpefl_n1KuzX1SkC5Abrk0xkcudLmFY6OamUnzHbL77GzQsOCek--tvF20Xrg4rPhsLzsinpwnhyP76cYOxQdbMzvtQjnvIFcGHniiLTwBGcANNP-XZbBfYqgCJMw&_kykmc_=AcUJtpX3xG5e7DEvvQ_0X9Tybvwg2JcKfCvMojtw2VttCIR_yCU3B6m-YvtH5bKlkKkKVwchuUQIbiTjaPL6dieFZl5eQJoasbzRK6IeM-WR_oX0qJe5AQuLIGT_Tl_j1KHHnnDwUfesS1yI2CzuvMuyTK6YlA8mSePnhK5oLQuO-Gpd-_bu3z3nVARZD44NAlJ03UJE0FZVWvBXq7RsrWmHtI87p5c2SoVeohErjMn_9wplKIJqd514WQMwP4n5xA",
                "afterclickUrl": {
                    "url": "/i/api/kn/afterclick/v1?searchId=vLAkOGif5s&exclProvider=BOOKINGDOTCOM",
                    "urlType": "relative"
                },
                "taxEstimated": false,
                "nonInstant": false,
                "direct": false,
                "whisky": false,
                "roomTypeCode": "406334204",
                "localizedAriaDescription": "Book this hotel on Booking.com for $756 per night",
                "privateDeal": false
            }
        ]
    },
    {
        "localizedDescription": "Queen Room - Free cancellation",
        "bookingOptions": [
            {
                "price": {
                    "price": 835,
                    "currency": "USD",
                    "localizedPrice": "$835"
                },
                "rateType": "bestAvailable",
                "totalPrice": {
                    "price": 835,
                    "currency": "USD",
                    "localizedPrice": "$835"
                },
                "localizedProviderName": "Booking.com",
                "providerCode": "BOOKINGDOTCOM",
                "logo": "http://content.r9cdn.net/rimg/provider-logos/hotels/h/BOOKINGDOTCOM.png?crop=false&width=166&height=62&fallback=default2.png&_v=1233faf051a0a6b9d9807846b1316f74",
                "bookingId": "06935cf6e1d6eac65161d05b5d2bb752",
                "freebies": [
                    {
                        "code": "freecancellation",
                        "localizedName": "Free cancellation"
                    }
                ],
                "bedCounts": {
                    "queen": 1
                },
                "bookingUrl": "/book/hotel?code=vLAkOGif5s.qumWFano8BP274JKcE0diPaeNWhRPjM7r__yfHjaxxI.96166.900265.MTc2MzQ0MjAwMDAwMF4xNzYzNTI4NDAwMDAwXjFeMl4=&h=3d90f976e2b0&sub=9&_sid_=R-4vx5D0Er1WMcOmnMykVoi-HXBZ2RHy_p4hwFwYcof61EvYJuOEBmXPl9bEZVpcK&cookieOverrides=x06b3gGbCKIdLNRjjfxr1aEQDUpefl_n1KuzX1SkC5Abrk0xkcudLmFY6OamUnzHbL77GzQsOCek--tvF20Xrg4rPhsLzsinpwnhyP76cYOxQdbMzvtQjnvIFcGHniiLTwBGcANNP-XZbBfYqgCJMw&_kykmc_=AcUJtpX3xG5e7DEvvQ_0X9Tybvwg2JcKfCvMojtw2VttCIR_yCU3B6m-YvtH5bKlkKkKVwchuUQIbiTjaPL6dieFZl5eQJoasbzRK6IeM-WR_oX0qJe5AQuLIGT_Tl_j1KHHnnDwUfesS1yI2CzuvMuyTK6YlA8mSePnhK5oLQuO-Gpd-_bu3z3nVARZD44NAlJ03UJE0FZVWvBXq7RsrWmHtI87p5c2SoVeohErjMn_9wplKIJqd514WQMwP4n5xA",
                "afterclickUrl": {
                    "url": "/i/api/kn/afterclick/v1?searchId=vLAkOGif5s&exclProvider=BOOKINGDOTCOM",
                    "urlType": "relative"
                },
                "taxEstimated": false,
                "nonInstant": false,
                "direct": false,
                "whisky": false,
                "roomTypeCode": "406334204",
                "localizedAriaDescription": "Book this hotel on Booking.com for $835 per night",
                "privateDeal": false
            }
        ]
    },
    {
        "localizedDescription": "Queen Room - Non Refundable",
        "bookingOptions": [
            {
                "price": {
                    "price": 756,
                    "currency": "USD",
                    "localizedPrice": "$756"
                },
                "rateType": "bestAvailable",
                "totalPrice": {
                    "price": 756,
                    "currency": "USD",
                    "localizedPrice": "$756"
                },
                "localizedProviderName": "Priceline",
                "providerCode": "PRICELINECORE",
                "logo": "http://content.r9cdn.net/rimg/provider-logos/hotels/h/PRICELINECORE.png?crop=false&width=166&height=62&fallback=default3.png&_v=b3e81884c7678f954cce1ed2c441273a",
                "bookingId": "67d584bb10b9ecd003f07179482cbc4e",
                "freebies": [],
                "bedCounts": {
                    "queen": 1
                },
                "bookingUrl": "/book/hotel?code=vLAkOGif5s.NjNQnTxaeC41pwi0WDvD6Rl2a7-GnfxY.87044.900265.MTc2MzQ0MjAwMDAwMF4xNzYzNTI4NDAwMDAwXjFeMl4=&h=78616eb08f92&sub=0&_sid_=R-4vx5D0Er1WMcOmnMykVoi-HXBZ2RHy_p4hwFwYcof61EvYJuOEBmXPl9bEZVpcK&cookieOverrides=x06b3gGbCKIdLNRjjfxr1aEQDUpefl_n1KuzX1SkC5Abrk0xkcudLmFY6OamUnzHbL77GzQsOCek--tvF20Xrg4rPhsLzsinpwnhyP76cYOxQdbMzvtQjnvIFcGHniiLTwBGcANNP-XZbBfYqgCJMw&_kykmc_=AcUJtpX3xG5e7DEvvQ_0X9Tybvwg2JcKfCvMojtw2VttCIR_yCU3B6m-YvtH5bKlkKkKVwchuUQIbiTjaPL6dieFZl5eQJoasbzRK6IeM-WR_oX0qJe5AQuLIGT_Tl_j1KHHnnDwUfesS1yI2CzuvMuyTK6YlA8mSePnhK5oLQuO-Gpd-_bu3z3nVARZD44NAlJ03UJE0FZVWvBXq7RsrWmHtI87p5c2SoVeohErjMn_9wplKIJqd514WQMwP4n5xA",
                "afterclickUrl": {
                    "url": "/i/api/kn/afterclick/v1?searchId=vLAkOGif5s&exclProvider=PRICELINECORE",
                    "urlType": "relative"
                },
                "taxEstimated": false,
                "nonInstant": false,
                "direct": false,
                "whisky": false,
                "roomTypeCode": "8987D7613979676E411580DDD2EAE201853E3CE2D8184ACDC5B91E5329AF9C01C12F3B262D4A8097AF0CDF483AA8139358BFDB31636DEB13083A6FE2362E74E2AC7CA198093E91A31AE147190B78E91F",
                "localizedAriaDescription": "Book this hotel on Priceline for $756 per night",
                "privateDeal": false
            }
        ]
    }
]
```