Concepts
Pricing & quotes
When prices appear, what they cover, and how the price filters behave.
Price quotes appear only when you search with dates. Omit checkin/checkout and results are static — no quotes, and the price filters are no-ops.
Where prices live
Per-supplier quotes live under suppliers.<name>.price, with total for the full stay in the response currency. Divide by meta.nights for the per-night price.
Set the response currency with currency.
Price filters
The min and max filters apply to the per-night price in USD and only run when checkin/checkout are also supplied.
Date rules
Explicit dates must be today or later and no more than two years in the future. Omitting dates yields static results.
Searching without dates is the fastest path when you only need availability and listings, not live prices.
What to read next
- Response & supplier model — where prices live in a result
- Caching — cache priced responses safely
- Locations & geocoding — where to search