{"uid":"cap_g6SgDGPAHrwEwHKJQ78tN","slug":"amadeus-a5d474a4","name":"Amadeus Hotel Offers Search","description":"Pay-per-request access to flights, award availability, hotels, activities, and transfers. No auth, no subscriptions.","url":"https://stabletravel.dev/api/hotels/search","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":["hotelIds"],"properties":{"lang":{"type":"string","description":"Language code (e.g. en)"},"adults":{"type":"number","description":"Number of adults (default 1)"},"hotelIds":{"type":"string","description":"Comma-separated Amadeus hotel IDs"},"boardType":{"enum":["ROOM_ONLY","BREAKFAST","HALF_BOARD","FULL_BOARD","ALL_INCLUSIVE"],"type":"string"},"priceRange":{"type":"string","description":"Price range (e.g. 100-300)"},"checkInDate":{"type":"string","description":"Check-in date (YYYY-MM-DD)"},"bestRateOnly":{"type":"boolean"},"checkOutDate":{"type":"string","description":"Check-out date (YYYY-MM-DD)"},"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","description":"Currency code"},"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":{"type":"array","items":{}}},"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"},"checkInDate":"2026-12-01","checkOutDate":"2026-12-05"}],"available":true}]}},"example":null,"exampleRequest":null,"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":"x402","network":"base","amountUsd":"0.0324","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0324","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_eWYMntgnI92gjVq6kKrzF","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 hotel offers and rates by Amadeus hotel IDs for specific dates and occupancy","exampleAgentPrompt":"Search hotel offers for Amadeus hotel IDs MCLONGHM and TELONGHM for 2 adults checking in on July 14 and checking out July 17, show only the best rate in USD with breakfast included.","exampleUseCases":null,"resultDescription":"An array of hotel offer objects containing available room types, rates, board type options, payment policies, and pricing for each requested hotel ID matching the search criteria.","failureModes":["Missing or invalid hotelIds returns an error — hotel IDs must be obtained from /hotels/list first","Invalid date format (not YYYY-MM-DD) causes a validation error","Check-out date before check-in date returns an error","Unsupported currency code returns a validation error","No availability for the requested dates returns an empty data array","Invalid price range format returns a parsing error"],"whenToPreferThis":"Use this endpoint when you already have Amadeus hotel IDs (from the /hotels/list endpoint) and need to retrieve current pricing, availability, and room offer details for specific stay dates. This is the right endpoint when you need to compare rates, filter by board type or payment policy, or prepare to book a specific hotel offer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:45:27.796Z","isFirstParty":false}