{"uid":"cap_6ojFh2mGfcBO5xgiFxCzR","slug":"amadeus-065cea67","name":"Amadeus Hotel Offers Search by Hotel ID","description":"Pay-per-request access to flights, award availability, hotels, activities, and transfers. No auth, no subscriptions.","url":"https://stabletravel.dev/api/hotels/search/by-hotel","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["hotelId"],"properties":{"lang":{"type":"string"},"adults":{"type":"number"},"hotelId":{"type":"string","description":"Amadeus hotel ID"},"boardType":{"enum":["ROOM_ONLY","BREAKFAST","HALF_BOARD","FULL_BOARD","ALL_INCLUSIVE"],"type":"string"},"priceRange":{"type":"string"},"checkInDate":{"type":"string"},"bestRateOnly":{"type":"boolean"},"checkOutDate":{"type":"string"},"currencyCode":{"enum":["CAD","HKD","ISK","PHP","DKK","HUF","CZK","AUD","RON","SEK","IDR","INR","BRL","RUB","HRK","JPY","THB","EUR","CHF","SGD","PLN","BGN","TRY","CNY","NOK","NZD","ZAR","USD","MXN","ILS","GBP","KRW","MYR"],"type":"string"},"includeClosed":{"type":"boolean"},"paymentPolicy":{"enum":["GUARANTEE","DEPOSIT","NONE"],"type":"string"},"countryOfResidence":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["data"],"properties":{"data":{}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"data":{"type":"hotel-offers","hotel":{"name":"Le Meridien Etoile","hotelId":"MCPAR123"},"offers":[{"id":"offer-1","price":{"total":"500.00","currency":"USD"}}],"available":true}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"hotelId":"MCLONGHM"}}},"response":{"data":[{"self":"https://api.amadeus.com/v3/shopping/hotel-offers?hotelIds=MCLONGHM","type":"hotel-offers","hotel":{"name":"JW Marriott Grosvenor House London","type":"hotel","dupeId":"700031300","hotelId":"MCLONGHM","cityCode":"LON","latitude":51.5095,"chainCode":"MC","longitude":-0.15536},"offers":[{"id":"S3YC8T60D0","room":{"type":"REG","description":{"lang":"EN","text":"Flexible Rate\nDeluxe Queen Room, Queen, Mini fridge,\n20sqm/215sqft-29sqm/312sqft, Wireless"},"typeEstimated":{"beds":1,"bedType":"QUEEN","category":"DELUXE_ROOM"}},"self":"https://api.amadeus.com/v3/shopping/hotel-offers/S3YC8T60D0","price":{"base":"605.00","total":"635.25","currency":"GBP","variations":{"average":{"base":"605.00"},"changes":[{"base":"605.00","endDate":"2026-05-30","startDate":"2026-05-29"}]}},"guests":{"adults":1},"policies":{"refundable":{"cancellationRefund":"REFUNDABLE_UP_TO_DEADLINE"},"paymentType":"guarantee","cancellations":[{"amount":"605.00","deadline":"2026-05-28T23:59:00+01:00","policyType":"CANCELLATION","numberOfNights":1}]},"rateCode":"RAC","checkInDate":"2026-05-29","checkOutDate":"2026-05-30","isLoyaltyRate":"Y","roomInformation":{"type":"REG","description":"Flexible Rate\nDeluxe Queen Room, Queen, Mini fridge,\n20sqm/215sqft-29sqm/312sqft, Wireless","typeEstimated":{"beds":1,"bedType":"QUEEN","category":"DELUXE_ROOM"},"providerContentReference":{"id":"GENR"}},"rateFamilyEstimated":{"code":"BAR","type":"P"}}],"available":true}]}},"exampleRequest":{"hotelId":"MCLONGHM"},"tags":["x402"],"displayCostAmount":"0.0324","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0324/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.0324","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.0324","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0324","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1VbqvCwMGEVsOt8jRVi3e","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.0324","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_GJFVQ_2Tgvn6ugwb5zqAM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0324","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search available room offers and rates for a specific hotel using its Amadeus hotel ID.","exampleAgentPrompt":"Can you find available room offers at the Amadeus hotel MCLONGHM for 2 adults checking in on June 15 and checking out June 18, showing only the best rates, breakfast included, priced in USD?","exampleUseCases":null,"resultDescription":"A list of hotel room offers for the specified hotel ID, including available room types, rates, board types (e.g. BREAKFAST, ALL_INCLUSIVE), payment policies, prices in the requested currency, and availability status.","failureModes":["Invalid or unknown hotelId returns no results or 404","Missing required hotelId parameter returns 400 bad request","Invalid date format for checkInDate or checkOutDate causes error","checkOutDate before or equal to checkInDate returns validation error","Unsupported currencyCode value returns error","No availability for the requested dates returns empty data array","Invalid boardType enum value returns 400"],"whenToPreferThis":"Use this endpoint when you already have a specific Amadeus hotel ID and want to retrieve room offers, rates, and availability for that hotel. Prefer this over a city-level hotel search when you've already identified the hotel and need detailed pricing. Best for itinerary building, price comparison for a known property, or completing a booking flow after hotel discovery.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:46:39.106Z","isFirstParty":false}