Release Notes

This page documents changes to the Partners API. Entries are organized by API version, then by date (newest first), and grouped into categories.

For details on what constitutes a breaking vs. non-breaking change, see API Versioning.

v1

2026-07-10

Added

• Webhooks are live for partners: register an endpoint to receive signed, real-time event notifications instead of polling. The initial events are account.created, account.refreshed, listing.created, listing.refreshed, and listing.base_price_changed. See Webhooks.

2026-06-30

Added

• List users now supports filter[email]=<email> to look up a user by email (exact, case-insensitive). Useful for recovering a user's id when you only have the email. See Users.

Changed

• The listing calendar endpoint (GET /api/v1/listings/{id}/calendar/) now requires the reservations:read scope instead of listings:read. Existing tokens that had listings:read were granted reservations:read so calendar access is uninterrupted; new tokens must request reservations:read to read the calendar. See Calendar.

2026-06-19

Added

• Calendar entries now include amount on each pricing factor: the factor's dollar contribution to the modeled price. See Calendar.
• Calendar entries now include effective-min-price and effective-max-price: the binding price floor and ceiling for each date. See Calendar.

2026-06-15

Added

• List comp sets now supports filter[owner]=<user_id> to narrow results to a single user (useful for full-access partner tokens).
• List comp sets now supports compound documents via ?include=owner,listing, sideloading the owning user and the anchored Beyond listing (listing is null for custom comp sets). See Compsets.

Changed

• The listing refresh endpoint (POST /listings/{id}/refresh/) now also refreshes the listing's details and availability, not just its reservations.

2026-06-13

Changed

• The optional X-Request-ID header now accepts any value made of letters, digits, and - _ . : separators (up to 128 chars), not just UUIDs. Values outside that set no longer return 400 — the API falls back to a generated request id instead.

2026-06-09

Added

• Compsets are live: list and retrieve competitive sets for your listings. See Compsets.

2026-06-08

Changed

• Deleting a user or a managed account now disables its listings.

2026-06-05

Fixed

• Retrieving min-stay customizations no longer fails for listings that have year-round last-minute (lead-time) min-stay rules configured.