IHG Rooms API

const params = new URLSearchParams({
  hotel_code: "USMKM",
  check_in: "2026-12-15",
  check_out: "2026-12-17",
  adults: 2,
});

const response = await fetch(
  `https://api.stayapi.com/v1/ihg/rooms?${params}`,
  { headers: { "x-api-key": "YOUR_API_KEY" } },
);
const data = await response.json();

const room = data.room_types[0];

// cheapest cash rate (whole-stay total, taxes included)
const cheapestCash = room.rates
  .reduce((a, b) => (a.total < b.total ? a : b));

// points-only redemption option (may not exist)
const pointsOnly = room.reward_options
  .find((o) => o.cash === null);

console.log(`${room.name}`);
console.log(`Cheapest cash: ${cheapestCash.total} ${cheapestCash.currency} (${cheapestCash.rate_plan_code})`);
if (pointsOnly) {
  console.log(`Points only: ${pointsOnly.points} pts/night`);
} else {
  console.log("no points-only option");
}

import requests

response = requests.get(
    "https://api.stayapi.com/v1/ihg/rooms",
    params={
        "hotel_code": "USMKM",
        "check_in": "2026-12-15",
        "check_out": "2026-12-17",
        "adults": 2,
    },
    headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()

room = data["room_types"][0]

# cheapest cash rate (whole-stay total, taxes included)
cheapest_cash = min(room["rates"], key=lambda r: r["total"])

# points-only redemption option (may not exist)
points_only = next(
    (o for o in room["reward_options"] if o["cash"] is None),
    None,
)

print(room["name"])
print(f"Cheapest cash: {cheapest_cash[\"total\"]} {cheapest_cash[\"currency\"]} ({cheapest_cash[\"rate_plan_code\"]})")
if points_only:
    print(f"Points only: {points_only[\"points\"]} pts/night")
else:
    print("no points-only option")

<?php
$params = http_build_query([
    "hotel_code" => "USMKM",
    "check_in" => "2026-12-15",
    "check_out" => "2026-12-17",
    "adults" => 2,
]);

$ch = curl_init("https://api.stayapi.com/v1/ihg/rooms?" . $params);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

$room = $data["room_types"][0];

// cheapest cash rate (whole-stay total, taxes included)
usort($room["rates"], fn($a, $b) => $a["total"] <=> $b["total"]);
$cheapestCash = $room["rates"][0];

// points-only redemption option (may not exist)
$pointsOnly = null;
foreach ($room["reward_options"] as $opt) {
    if (is_null($opt["cash"])) { $pointsOnly = $opt; break; }
}

echo $room["name"] . "\n";
echo "Cheapest cash: {$cheapestCash[\"total\"]} {$cheapestCash[\"currency\"]} ({$cheapestCash[\"rate_plan_code\"]})\n";
if ($pointsOnly) {
    echo "Points only: {$pointsOnly[\"points\"]} pts/night\n";
} else {
    echo "no points-only option\n";
}
?>

require "net/http"
require "uri"
require "json"

uri = URI("https://api.stayapi.com/v1/ihg/rooms")
uri.query = URI.encode_www_form(
  hotel_code: "USMKM",
  check_in: "2026-12-15",
  check_out: "2026-12-17",
  adults: 2,
)

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "YOUR_API_KEY"

data = JSON.parse(http.request(request).body)
room = data["room_types"][0]

# cheapest cash rate (whole-stay total, taxes included)
cheapest_cash = room["rates"].min_by { |r| r["total"] }

# points-only redemption option (may not exist)
points_only = room["reward_options"].find { |o| o["cash"].nil? }

puts room["name"]
puts "Cheapest cash: \#{cheapest_cash[\"total\"]} \#{cheapest_cash[\"currency\"]} (\#{cheapest_cash[\"rate_plan_code\"]})"
if points_only
  puts "Points only: \#{points_only[\"points\"]} pts/night"
else
  puts "no points-only option"
end

{
  "type": "https://api.stayapi.com/errors/hotel-not-found",
  "title": "Hotel Not Found",
  "status": 404,
  "detail": "Hotel code not recognized by IHG: ZZZZZ",
  "instance": "/v1/ihg/rooms",
  "provider": "ihg",
  "product": "rooms",
  "error_code": "HOTEL_NOT_FOUND",
  "correlation_id": "29caac72-47db-4316-ab26-3aeb8c8c1264"
}

{
  "type": "https://api.stayapi.com/errors/invalid-dates",
  "title": "Invalid Dates",
  "status": 400,
  "detail": "Check-out date must be after check-in date",
  "instance": "/v1/ihg/rooms",
  "provider": "ihg",
  "product": "rooms",
  "error_code": "INVALID_DATES",
  "correlation_id": "bb4fec53-19b8-4056-a456-d4ec8202018b"
}

{
  "type": "https://api.stayapi.com/errors/upstream-error",
  "title": "Upstream Error",
  "status": 502,
  "detail": "Failed to fetch room data: HTTP 503",
  "instance": "/v1/ihg/rooms",
  "provider": "ihg",
  "product": "rooms",
  "error_code": "UPSTREAM_ERROR",
  "correlation_id": "6bc0f955-18c9-4567-9183-75d5c01117b6",
  "upstream_status": 503
}