List hotels by IATA city code via Amadeus GDS — $0.03 per request, no API keys needed.
What it does
The `/api/hotels/list` endpoint on StableTravel returns a list of hotels for a given IATA city code (e.g. PAR, LON, NYC). It queries the Amadeus GDS and returns up to 100 hotel results by default, including Amadeus hotel IDs that can be used in subsequent `/api/hotels/search` and `/api/hotels/book` calls. Optional filters include search radius, radius unit (KM or MILE), hotel chain codes, amenities, star ratings (1–5), hotel source (BEDBANK, DIRECTCHAIN, ALL), and a max result count.
This endpoint is part of the broader StableTravel API suite, which provides pay-per-request access to flights, hotels, activities, transfers (via Amadeus), real-time flight tracking (via FlightAware), and Google Flights price comparison. No API keys, OAuth tokens, or subscriptions are required — payment is handled automatically via the MPP/x402 micropayment protocol using USDC on Base, Solana, or Tempo. The typical hotel booking workflow is: list hotels (get IDs) → search offers by hotel IDs → get offer details → book.
The endpoint costs $0.032400 per call, settled via the Tempo L2 method (chainId 4217). The MPP 402 challenge was captured and confirms the endpoint is live. A full OpenAPI 3.1 spec with parameter definitions and response schemas is available at `/openapi.json`.
Capabilities
Use cases
- —An AI travel agent listing available hotels in a destination city before presenting options to a user
- —A trip-planning workflow that collects hotel IDs to feed into offer search and booking endpoints
- —Filtering hotels by star rating and amenities for a corporate travel policy
- —Building a hotel comparison tool that aggregates properties across multiple cities
Fit
Best for
- —Autonomous AI agents that need hotel inventory without managing API credentials
- —Pay-as-you-go hotel discovery where you only pay when you actually query
- —Multi-step booking workflows: list → search offers → book
Not for
- —Bulk hotel data scraping or full-catalog exports (max 100 results per call)
- —Direct hotel booking — this endpoint only lists hotels; use /api/hotels/search and /api/hotels/book for offers and reservations
Quick start
npx agentcash fetch "https://stabletravel.dev/api/hotels/list?cityCode=PAR&max=10&ratings=4,5"Example
Response
{
"data": [
{
"name": "Example Hotel Paris",
"rating": 4,
"hotelId": "HSPARXYZ",
"iataCode": "PAR",
"chainCode": "HI"
}
],
"meta": {
"count": 1
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with parameter definitions and response structure, live 402 MPP challenge captured confirming the endpoint is operational, clear pricing ($0.0324/call), and comprehensive guidance documentation. Slightly below 0.9 because the response schema's data items are typed as empty `{}` (no detailed hotel object schema) and no example response is provided in the spec.
Warnings
- —Response data item schema is untyped (empty object) in the OpenAPI spec — actual response structure must be inferred from Amadeus documentation
- —Example response JSON above is illustrative and not sourced from actual API output
Citations
- —The /api/hotels/list endpoint costs $0.032400 per request in USDhttps://stabletravel.dev/openapi.json
- —Required parameter is cityCode (IATA city code); optional parameters include radius, radiusUnit, chainCodes, amenities, ratings, hotelScore, and maxhttps://stabletravel.dev/openapi.json
- —Payment is via MPP protocol using Tempo method (chainId 4217) with no API keys requiredhttps://stabletravel.dev/openapi.json
- —The typical hotel booking workflow is list → search → offer → bookhttps://stabletravel.dev
- —StableTravel provides pay-per-request access to Amadeus and FlightAware data with no auth or subscriptionshttps://stabletravel.dev