# Amadeus Hotel Offers Search

> Amadeus Hotel Offers Search is a paid API for AI agents from stabletravel.dev, paid per call via x402, $0.0324/call, status unknown (last checked 2026-09-14).

Search available hotel offers and rates by Amadeus hotel IDs for specific dates and occupancy

## Facts

- Endpoint: GET https://stabletravel.dev/api/hotels/search
- Price: $0.0324/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/amadeus-a5d474a4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_g6SgDGPAHrwEwHKJQ78tN

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability amadeus-a5d474a4
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Pay-per-request access to flights, award availability, hotels, activities, and transfers. No auth, no subscriptions.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/amadeus-a5d474a4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stabletravel.dev](https://www.zero.xyz/host/stabletravel.dev/llms.txt)