Price a hotel stay
quote_hotel_stayRead-only
Gets a live supplier offer or MBD contract price (pricingSource) for hotels and dates. Books nothing and holds no room. An unverified price is not returned. PRICE_ON_REQUEST means no price is on file; the reply then carries pageUrl and contact. Supplier calls are limited daily. Needs check-in, check-out and guests. When nationality is omitted the price is for TR and the reply states nationalityUsed.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| adults | Yes | Adults; at most 6 people per room, 4 children. | |
| checkIn | Yes | Check-in date; at most 365 days from today (YYYY-MM-DD) | |
| checkOut | Yes | Check-out date; the stay must be 1-30 nights (YYYY-MM-DD) | |
| currency | Yes | ||
| hotelIds | Yes | hotelId values (ids, not names). | |
| language | Yes | ||
| nationality | No | ISO 3166-1 alpha-2 code (TR, AE, DE); optional, default TR. Changes the price. | |
| childrenAges | No | Age of each child, one entry per child. No birth dates. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| quotes | Yes | ||
| handoff | No | ||
| deepLink | Yes | ||
| quotedAt | Yes | ||
| disclaimer | No | ||
| generatedAt | No | ||
| deepLinkNote | No | ||
| liveQuoteLimit | No | ||
| nationalityNote | No | ||
| nationalityUsed | No | ||
| catalogueRefreshedAt | No | ||
| nationalityDefaulted | No |