Pricing

get_listing_prices

Returns the pricing calendar for one listing over a date range (listing_id, pms_name, date_from, date_to as YYYY-MM-DD).

Best for: Reviewing upcoming daily prices, checking what PriceLabs recommends for specific dates.

Example: “Show me prices for Sunset Villa next month”

refresh_listing_pricing

Recomputes and returns the refreshed daily pricing calendar for one listing. Optionally includes a pricing-reason breakdown. Requires OAuth write access.

Best for: Forcing a price refresh after changing settings, seeing updated recommendations immediately.

Example: “Refresh pricing for Sunset Villa”

get_listing_rate_plans

Lists the rate plans configured on a listing, including plan identifiers, display names, and how each plan updates prices. Useful when you manage multiple rate tiers (e.g. standard vs. non-refundable) and want to see what’s active.

Best for: Auditing rate plan setup, verifying which plans apply to a listing.

Example: “What rate plans are set for my listing Sunset Villa?”

get_listing_date_overrides

Shows future date-specific overrides (DSOs) on a listing — custom prices, minimum-stay rules, and other per-day settings you’ve applied outside your base pricing. Only returns upcoming overrides, not historical ones.

Best for: Checking if custom pricing is set for holidays, events, or specific date ranges.

Example: “Do I have custom prices set for next weekend for Sunset Villa?”

update_listing_date_overrides

Creates or updates future date-level overrides for one listing — set per-date price, min-stay, min/max bounds, check-in/out rules, reason, and more. Requires OAuth write access; use get_listing_date_overrides to read current rules first.

Best for: Setting holiday pricing, event minimum stays, or custom rules from chat.

Example: “Set a $500 minimum price for New Year’s Eve on Sunset Villa”

delete_listing_date_overrides

Removes date-level overrides on specific dates for one listing so it reverts to standard pricing. Requires OAuth write access.

Best for: Clearing custom pricing or min-stay rules that are no longer needed.

Example: “Remove the override for March 15 on Sunset Villa”