{"uid":"cap_GTj2eWKz9554TVTBwDlNG","slug":"amadeus-8123b7f3","name":"Amadeus Hotel List by City","description":"Pay-per-request access to flights, award availability, hotels, activities, and transfers. No auth, no subscriptions.","url":"https://stabletravel.dev/api/hotels/list?utm_source=zero.xyz","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":["cityCode"],"properties":{"max":{"type":"number","description":"Maximum number of results (default 100)"},"radius":{"type":"number","description":"Search radius"},"ratings":{"type":"string","description":"Comma-separated star ratings (1-5)"},"cityCode":{"type":"string","description":"IATA city code (e.g. PAR)"},"amenities":{"type":"string","description":"Comma-separated amenity codes"},"chainCodes":{"type":"string","description":"Comma-separated hotel chain codes"},"hotelScore":{"enum":["BEDBANK","DIRECTCHAIN","ALL"],"type":"string","description":"Hotel source filter"},"radiusUnit":{"enum":["KM","MILE"],"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":{}},"meta":{}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"data":[{"name":"Le Meridien Etoile","dupeId":700001234,"address":{"countryCode":"FR"},"geoCode":{"latitude":48.877,"longitude":2.285},"hotelId":"MCPAR123","iataCode":"PAR","chainCode":"MC"}],"meta":{"count":1}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"max":50,"radius":10,"ratings":"4,5","cityCode":"PAR","radiusUnit":"KM"}}},"response":{"_truncated":true,"_originalSize":18431}},"exampleRequest":{"max":50,"radius":10,"ratings":"4,5","cityCode":"PAR","radiusUnit":"KM"},"tags":["x402"],"displayCostAmount":"0.0324","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.08","successRate":"0.00","reviews":1,"stars":"1.3","state":"rated"},"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_Zm6sDV4QdxvONimz3BD7i","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":"Returns a list of hotels in a given city using an IATA city code, with optional filters for radius, ratings, amenities, and chain codes.","exampleAgentPrompt":"Can you list up to 50 hotels in Paris — 4 or 5 stars only — within 10 km of the city center, from any source?","exampleUseCases":[{"title":"Planning a family vacation with specific needs","prompt":"I need to find hotels in Tokyo that have swimming pools and are rated 4 stars or higher — can you show me what's available so I can pick one that the kids will enjoy?"},{"title":"Corporate travel booking for executive visit","prompt":"Pull up a list of luxury 5-star hotels in Singapore for our CEO's conference trip next month — I want to see the top options before we make a reservation."},{"title":"Budget accommodation search for backpackers","prompt":"What budget-friendly hotels can you find in Barcelona with good reviews? I'm looking for places under a certain rating that are still decent and near the city center."}],"resultDescription":"An array of hotel objects matching the search criteria, including hotel identifiers and metadata, along with pagination/meta information. Up to the specified maximum (default 100) results are returned.","failureModes":["Missing or invalid IATA city code returns a 400 or empty result","Invalid radius unit or rating value causes a parameter error","No hotels found for very restrictive filter combinations returns empty data array","Payment failure (x402) if USDC balance is insufficient","Rate limiting or upstream Amadeus API unavailability returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need to discover or enumerate hotels in a specific city before booking or fetching offer details. It is the right starting point for hotel search workflows when you have an IATA city code and want to filter by star rating, amenity, or chain. Prefer this over flight or activity endpoints when the user's intent is specifically hotel discovery.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-06-28T22:56:31.678Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:40:27.792Z","isFirstParty":false,"canonicalSlug":"amadeus-8123b7f3"}