Pricing Rules
Pricing rules express your policy on top of AirROI's date-specific model. They are optional: an omitted rule is off. Start with one rule, inspect its explanation, then add the next.
Choose a rule by the problem you need to solve
| Your question | Start here |
|---|---|
| How should rates change close to arrival? | Last-minute pricing |
| What should I charge far in advance? | Far-future pricing |
| Can I fill a short gap between bookings? | Gap-night pricing |
| Should nights beside a booking get an adjustment? | Adjacent-day pricing |
| Is this property's booking calendar filling up? | Occupancy pacing |
| Can I change weekdays or stay restrictions? | Weekday and stay rules |
| Can a policy differ by month or event dates? | Seasonal rule overrides |
| Can I bound or explicitly set a price? | Price limits and overrides |
Rule modes and presets
Each last-minute preset has its own window, maximum discount, and curve shape.
Start by comparing the shapes, not just the names. A conservative last-minute rule acts over fewer days with a smaller maximum discount; aggressive changes both the window and the curve. “Disabled” means this optional rule is off—not that the model returns a flat calendar.
Omit a rule or use {"mode": "disabled"} to turn it off.
last_minute, far_future, and gap_day support presets:
{
"pricing_rules": {
"last_minute": {"mode": "balanced"},
"far_future": {"mode": "balanced"},
"gap_day": {"mode": "balanced"}
}
}
| Preset | Last-minute discount | Far-future premium | Gap discount: 1 / 2 / 3 nights |
|---|---|---|---|
| conservative | 0% at 7 days out → −8% today | 0% at 270 days → +3% at 365 days, held beyond | −4% / −2% / 0% |
| balanced | 0% at 21 days out → −15% today | 0% at 180 days → +7% at 365 days, held beyond | −8% / −4% / −2% |
| aggressive | 0% at 45 days out → −25% today | 0% at 120 days → +12% at 365 days, held beyond | −12% / −8% / −4% |
Last-minute presets use curved ramps; far-future presets ramp linearly.
Preset gap rules apply on weekends and need the calendar described in the gap-night guide.
Other rules accept only custom or
disabled. Custom rules require complete settings; do not send settings,
overrides, or apply_on_weekends with a preset or disabled mode.
Understand the order before combining rules
The five automatic pricing rules add their percentages against the same post-model price, without a combined cap. Custom weekday adjustments and explicit percentage overrides follow. Price limits follow, but a fixed override takes priority over those limits.
Illustrative USD prices, not a live recommendation. Hold gap discount at −15%, occupancy pacing at −10%, and custom weekday at +10%. Assume each rule qualifies.
Combined automatic adjustment: -45%. Price limits apply after these adjustments.
| Stage | USD per night |
|---|---|
| After model effects | $200.00 |
| Automatic rules -45% | $110.00 |
| Custom weekday +10% | $121.00 |
| After $150 minimum | $150.00 |
Automatic rules share the same $200 basis. The custom weekday adjustment comes afterward. A fixed price override, if supplied, would bypass this minimum.
Explore the rules
- Last-Minute Pricing: Flat and Gradual Adjustments
Compare flat and gradual last-minute pricing, see the preset curves, and calculate a custom discount as arrival approaches.
- Far-Future Pricing: Premiums and Lead-Time Ramps
Set flat or gradual far-future adjustments, choose where the ramp completes with end_days, and see why the premium holds beyond it.
- Gap-Night Pricing: Discount Bookable Gaps
See how known calendar boundaries, minimum stays, weekend settings, and gap length determine whether a discount applies.
- Adjacent-Day Pricing: Nights Beside Reservations
Adjust available nights before or after a reservation and see how gaps, blocked nights, and weekends affect eligibility.
- Occupancy Pacing: Calendar Evidence and Rule Matrices
Calculate property occupancy by lead-time window, choose the right matrix cell, and understand the complete-calendar requirement.
- Weekday Pricing, Minimum Stays, and Check-In Rules
Configure weekday adjustments and stay restrictions, with explicit examples of output fields and length-of-stay limitations.
- Seasonal Rule Overrides: Date Ranges, Months, and Defaults
Use complete custom settings for event dates or recurring months, and understand date-range precedence without partial inheritance.
- Price Limits and Overrides: Which Setting Wins?
Trace minimums, maximums, percentage overrides, and fixed prices—including why a fixed amount can exceed your maximum.
- Calendar Data Guide for Price Recommendations
Map available, reserved, and blocked nights correctly, supply rule evidence, and avoid confusing input dates with the response horizon.
- World Cup Pricing Example: Three Nights, Explained
Follow a Miami Beach two-bedroom through three consecutive World Cup nights: model effects, stacked discounts, custom adjustments, a minimum price, and a fixed override, each receipt line explained with interactive charts and a what-if explorer.