# 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 |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| api\_key
required
| Your personal API key. |
| hotelid
required
| ID of the hotel. [Contact](https://share.hsforms.com/1A-iwjye2SwWRv4VHhQbBqg439wf) us to get this data. |
| rooms
required
| It is the number of rooms. |
| adults
required
| It is the number of adults. |
| checkin
required
| It is the check-in date.
Format - YYYY-MM-DD
|
| checkout
required
| It is the check-out date.
Format - YYYY-MM-DD
|
### 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
}
]
}
]
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.makcorps.com/hotel-price-apis/room-type-api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.