- ✨ Document the read-only Booking Cancelation Protection Summaries resource — the per-booking summary of cancelation-protection amounts (commissionable amount, eligible protection amount, rent revenue,
policy, and churned_at) used for accounting reconciliation. Listing and fetching require the new bookings_cancelation_protection_read OAuth scope, which grants read access to this data.
- ✨ Introduce the experimental MCP server — exposing API v3 over the Model Context Protocol so AI clients can query Smily resources directly. Covers authentication (header and URL tokens, single- and multi-account tokens with per-request account selection), the four tools, querying (filters, sparse fieldsets, pagination), the resource catalog, connecting clients (Claude Code, Claude Cowork, Codex), testing with MCP Inspector, and the JSON-RPC protocol.
- ✨ Expose
payment_charge_commission on the Bookings endpoint — the Payment Charge commission amount — the commission charged by an OTA for processing payments (e.g. Payments by Booking.com). Available on the bookings_write_owned, bookings_read, and bookings_write scopes.
- 📚 Document the accuracy caveat: when the payout has not yet been reconciled from Booking.com via Smily Pay, the value may be off by approximately one cent — the real amount is only known once the payout is reconciled.
- ✨ Expose
start_at_global and end_at_global on the Booking resource. These are the booking's check-in and check-out as true UTC instants (rental's timezone applied), suitable for absolute time-window comparisons. The existing start_at and end_at remain wall-clock values in the rental's local timezone.
- ✨ Return
Retry-After header on 429 rate limit responses, and clarify rate limiting scope (per OAuth application, no per-endpoint sub-limits).
- ✨ Document the difference between
map and map_with_price_variation on the Mid Term Rate Map endpoint, and how the per-day price modifier is resolved from Applications Periods Rentals and the Application's default_price_increase.
- ✨ Document the application lock behavior when setting
nightly_rates_managed_externally to true on a Rental: rates management is locked to the calling application, and a different application attempting to update the Nightly Rate Map will receive an explicit error.
- ✨ Add
classified_kind attribute to Bookings Fees and Bookings Taxes endpoints.
- ✨ Add support for selectable adding/removing or bookings tags on a booking level..