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.
Reading suppliers.<name>.price
The field is per supplier and has three states — the price is never returned as 0:
price | Meaning |
|---|---|
{ "total": 420 } | The supplier returned a live quote. |
null | We tried to quote this supplier but couldn't reach it — availability is unknown, not sold out. Don't treat null as free or unavailable. |
| omitted | Pricing didn't run (no dates), or the supplier returned no quote on a healthy priced request. |
Because the states are per supplier, one stay can mix them: during a partial outage suppliers.booking.price may be a quote while suppliers.expedia.price is null on the same result. An omitted field across all suppliers with no dates just means you didn't search with dates.
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