# Wheelhouse API > Wheelhouse Revenue Management (RM) API: price recommendations, listing preferences, custom rates, reservations, and portfolio management for short-term rental pricing. The API is in beta. Base URL: https://api.usewheelhouse.com/ss_api/v1. Direct HTTP integrations authenticate with an RM API key in the `X-Integration-Api-Key` header; AI agents can use the Wheelhouse MCP server with OAuth instead. Every docs page has a Markdown version: its URL plus `.md` (`/index.md` for the home page). [llms-full.txt](https://docs.usewheelhouse.com/llms-full.txt) has all of them in one file. ## OpenAPI specification - [OpenAPI spec (YAML)](https://docs.usewheelhouse.com/rm/openapi.yaml): the full RM API specification, always the latest version - [OpenAPI spec (JSON)](https://docs.usewheelhouse.com/rm/openapi.json): the same specification as JSON ## Docs - [Overview](https://docs.usewheelhouse.com/index.md) - [Authentication](https://docs.usewheelhouse.com/rm/authentication.md) - [MCP Server](https://docs.usewheelhouse.com/rm/mcp.md) - [Agent Plugin](https://docs.usewheelhouse.com/rm/wheelhouse-plugin.md) - [Usage & Limits](https://docs.usewheelhouse.com/rm/usage.md) - [Identifying Listings](https://docs.usewheelhouse.com/rm/concepts/listings.md) - [Listing Preferences](https://docs.usewheelhouse.com/rm/concepts/preferences.md) - [Preferences Rules](https://docs.usewheelhouse.com/rm/concepts/preferences-rules.md) - [Dynamic Sets](https://docs.usewheelhouse.com/rm/concepts/dynamic-sets.md) - [Pricing Tiers](https://docs.usewheelhouse.com/rm/concepts/pricing-tiers.md) - [Changelog](https://docs.usewheelhouse.com/rm/changelog.md) - [API Reference](https://docs.usewheelhouse.com/rm/reference/wheelhouse-revenue-management-api.md) ## Endpoints ### [Listings](https://docs.usewheelhouse.com/rm/reference/listings.md) - [GET /listings](https://docs.usewheelhouse.com/rm/reference/rm-get-listings.md): Retrieve all listings for the authenticated user. - [GET /listings/kpis](https://docs.usewheelhouse.com/rm/reference/rm-get-bulk-listing-kpis.md): Rank every listing by one KPI. - [GET /listings/{listing_id}](https://docs.usewheelhouse.com/rm/reference/rm-get-listing.md): Get a single listing. - [GET /listings/{listing_id}/pricing_tier](https://docs.usewheelhouse.com/rm/reference/rm-get-listing-pricing-tier.md): Get the pricing tier for a listing. - [GET /listings/{listing_id}/recent_changes](https://docs.usewheelhouse.com/rm/reference/rm-get-listing-recent-changes.md): Get times of latest changes for a listing. - [POST /listings/{listing_id}/sync](https://docs.usewheelhouse.com/rm/reference/rm-post-listing-sync.md): Trigger a manual sync for a listing. - [GET /listings/{listing_id}/kpis](https://docs.usewheelhouse.com/rm/reference/rm-get-listing-kpis.md): Get rolling-window KPIs for a listing. - [GET /listings/{listing_id}/kpis/monthly](https://docs.usewheelhouse.com/rm/reference/rm-get-listing-kpis-monthly.md): Get monthly stats for a listing. - [GET /listings/{listing_id}/kpis/quarterly](https://docs.usewheelhouse.com/rm/reference/rm-get-listing-kpis-quarterly.md): Get quarterly stats for a listing. - [GET /listings/{listing_id}/kpis/yearly](https://docs.usewheelhouse.com/rm/reference/rm-get-listing-kpis-yearly.md): Get yearly stats for a listing. ### [Recommendations](https://docs.usewheelhouse.com/rm/reference/recommendations.md) - [GET /listings/{listing_id}/price_recommendations](https://docs.usewheelhouse.com/rm/reference/rm-get-price-recommendations.md): Get daily price recommendations for a listing. - [GET /price_models](https://docs.usewheelhouse.com/rm/reference/rm-get-price-models.md): List the price models customers can pick from. - [POST /preferences/{listing_id}/preview](https://docs.usewheelhouse.com/rm/reference/rm-preview-preferences.md): Preview price recommendations for a listing with hypothetical preference changes. - [GET /listings/{listing_id}/base_price_recommendation](https://docs.usewheelhouse.com/rm/reference/rm-get-base-price-recommendation.md): Get base price recommendation options for a listing. - [GET /listings/{listing_id}/checkin_checkout](https://docs.usewheelhouse.com/rm/reference/rm-get-checkin-checkout.md): Get check-in/check-out calendar for a listing. - [GET /listings/{listing_id}/min_max_prices](https://docs.usewheelhouse.com/rm/reference/rm-get-min-max-prices.md): Get minimum and maximum price calendar for a listing. - [GET /listings/{listing_id}/monthly_seasonality](https://docs.usewheelhouse.com/rm/reference/rm-get-monthly-seasonality.md): Get recommended monthly seasonality adjustment factors for a listing. - [GET /listings/{listing_id}/base_price_history](https://docs.usewheelhouse.com/rm/reference/rm-get-base-price-history.md): Get the base price recommendation history for a listing. ### [Listing Preferences](https://docs.usewheelhouse.com/rm/reference/listing-preferences.md) - [GET /preferences](https://docs.usewheelhouse.com/rm/reference/rm-get-preferences-batch.md): Retrieve preferences for a batch of listings. - [PUT /preferences](https://docs.usewheelhouse.com/rm/reference/rm-put-preferences-batch.md): Update preferences for a batch of listings. - [GET /preferences/{listing_id}](https://docs.usewheelhouse.com/rm/reference/rm-get-preferences.md): Get preferences for a listing. - [PUT /preferences/{listing_id}](https://docs.usewheelhouse.com/rm/reference/rm-put-preferences.md): Update preferences for a listing. - [PUT /preferences/{listing_id}/copy](https://docs.usewheelhouse.com/rm/reference/rm-copy-preferences.md): Copy preferences from one listing to another. - [PUT /preferences/{listing_id}/{setting}](https://docs.usewheelhouse.com/rm/reference/rm-put-preference-setting.md): Update a single pricing setting for a listing. - [GET /preferences/{listing_id}/long_term_discounts](https://docs.usewheelhouse.com/rm/reference/rm-get-long-term-discounts.md): Get the long-term discount settings for a listing. - [GET /preferences/{listing_id}/changelog](https://docs.usewheelhouse.com/rm/reference/rm-get-preferences-changelog.md): Get the changelog of all changes to a listing. ### [Custom Rates](https://docs.usewheelhouse.com/rm/reference/custom-rates.md) - [GET /listings/{listing_id}/custom_rates](https://docs.usewheelhouse.com/rm/reference/rm-get-custom-rates.md): Get all active and upcoming custom rates for a listing. - [PUT /listings/{listing_id}/custom_rates](https://docs.usewheelhouse.com/rm/reference/rm-put-custom-rate.md): Set a custom rate for a listing. - [DELETE /listings/{listing_id}/custom_rates](https://docs.usewheelhouse.com/rm/reference/rm-delete-custom-rate.md): Delete custom rates for a date range on a listing. - [PUT /listings/{listing_id}/bulk_custom_rates](https://docs.usewheelhouse.com/rm/reference/rm-bulk-put-custom-rates.md): Set multiple custom rates for a listing in bulk. - [DELETE /listings/{listing_id}/bulk_custom_rates](https://docs.usewheelhouse.com/rm/reference/rm-bulk-delete-custom-rates.md): Delete multiple custom rate ranges for a listing in bulk. ### [Reservations](https://docs.usewheelhouse.com/rm/reference/reservations.md) - [GET /listings/{listing_id}/reservations](https://docs.usewheelhouse.com/rm/reference/rm-get-reservations.md): Get reservations for a listing. ### [Listing Tags](https://docs.usewheelhouse.com/rm/reference/listing-tags.md) - [GET /listings/{listing_id}/tags](https://docs.usewheelhouse.com/rm/reference/rm-get-tags.md): Get user-defined tags for a listing. - [PUT /listings/{listing_id}/tags](https://docs.usewheelhouse.com/rm/reference/rm-put-tags.md): Update user-defined tags for a listing. ### [Listing OTA Links](https://docs.usewheelhouse.com/rm/reference/listing-ota-links.md) - [GET /listings/{listing_id}/ota_links](https://docs.usewheelhouse.com/rm/reference/rm-get-ota-links.md): List a listing's links to other booking platforms. - [PUT /listings/{listing_id}/ota_links](https://docs.usewheelhouse.com/rm/reference/rm-put-ota-link.md): Add a link to another booking platform. - [DELETE /listings/{listing_id}/ota_links/{link_id}](https://docs.usewheelhouse.com/rm/reference/rm-delete-ota-link.md): Remove a link to another booking platform. ### [Listing Flags](https://docs.usewheelhouse.com/rm/reference/listing-flags.md) - [GET /listings/{listing_id}/flags](https://docs.usewheelhouse.com/rm/reference/rm-get-flags.md): Get system-defined flags for a listing. ### [Notes](https://docs.usewheelhouse.com/rm/reference/notes.md) - [GET /listings/{listing_id}/notes](https://docs.usewheelhouse.com/rm/reference/rm-get-notes.md): Get the notes of a listing. - [POST /listings/{listing_id}/notes](https://docs.usewheelhouse.com/rm/reference/rm-post-note.md): Create a note on a listing. - [PUT /listings/{listing_id}/notes/{note_id}](https://docs.usewheelhouse.com/rm/reference/rm-put-note.md): Update a note. - [DELETE /listings/{listing_id}/notes/{note_id}](https://docs.usewheelhouse.com/rm/reference/rm-delete-note.md): Delete a note. ### [Calendar](https://docs.usewheelhouse.com/rm/reference/calendar.md) - [GET /listings/{listing_id}/price_calendar](https://docs.usewheelhouse.com/rm/reference/rm-get-price-calendar.md): Get the price calendar for a listing. - [GET /listings/{listing_id}/last_posted_prices](https://docs.usewheelhouse.com/rm/reference/rm-get-last-posted-prices.md): Get the last posted price per stay date for a listing. - [GET /listings/{listing_id}/calendar_day_history](https://docs.usewheelhouse.com/rm/reference/rm-get-calendar-day-history.md): Get the historical snapshots of a calendar day for a listing. - [GET /listings/{listing_id}/fee_impact_calendar](https://docs.usewheelhouse.com/rm/reference/rm-get-fee-impact-calendar.md): Get the estimated fee multiplier per stay date for a listing. - [GET /listings/{listing_id}/min_stay_calendar](https://docs.usewheelhouse.com/rm/reference/rm-get-min-stay-calendar.md): Get the minimum stay calendar for a listing. ### [Segments](https://docs.usewheelhouse.com/rm/reference/segments.md) - [GET /segments](https://docs.usewheelhouse.com/rm/reference/rm-get-segments.md): List portfolio segments. - [POST /segments](https://docs.usewheelhouse.com/rm/reference/rm-post-segments.md): Create a portfolio segment. - [PUT /segments/{segment_id}](https://docs.usewheelhouse.com/rm/reference/rm-put-segment.md): Update a portfolio segment. - [DELETE /segments/{segment_id}](https://docs.usewheelhouse.com/rm/reference/rm-delete-segment.md): Delete a portfolio segment. - [GET /segments/{segment_id}/listings](https://docs.usewheelhouse.com/rm/reference/rm-get-segment-listings.md): List listings in a segment. - [GET /segments/{segment_id}/aggregated_metrics](https://docs.usewheelhouse.com/rm/reference/rm-get-segment-aggregated-metrics.md): Get aggregated metrics for a segment. ### [Market Reports](https://docs.usewheelhouse.com/rm/reference/market-reports.md) - [GET /market_report](https://docs.usewheelhouse.com/rm/reference/rm-get-market-report.md): List markets for a country. - [GET /market_report/{market_id}/bedroom_groups](https://docs.usewheelhouse.com/rm/reference/rm-get-market-bedroom-groups.md): Get the bedroom groups a market is broken down by. - [GET /market_report/{market_id}/time_series](https://docs.usewheelhouse.com/rm/reference/rm-get-market-time-series.md): Get time-series market metrics. - [GET /market_report/{market_id}/distribution](https://docs.usewheelhouse.com/rm/reference/rm-get-market-distribution.md): Get market metric distributions for a month. ### [Neighborhood Data](https://docs.usewheelhouse.com/rm/reference/neighborhood-data.md) - [GET /listings/{listing_id}/neighborhood/pricing](https://docs.usewheelhouse.com/rm/reference/rm-get-neighborhood-pricing.md): Get daily neighborhood pricing data for a listing. - [GET /listings/{listing_id}/neighborhood/occupancy](https://docs.usewheelhouse.com/rm/reference/rm-get-neighborhood-occupancy.md): Get daily neighborhood occupancy and booking data for a listing. ### [Dynamic Sets](https://docs.usewheelhouse.com/rm/reference/dynamic-sets.md) - [GET /sets](https://docs.usewheelhouse.com/rm/reference/rm-get-sets.md): List dynamic sets. - [POST /sets](https://docs.usewheelhouse.com/rm/reference/rm-create-set.md): Create a dynamic set. - [GET /sets/candidates](https://docs.usewheelhouse.com/rm/reference/rm-get-set-candidates.md): Search candidate listings for a dynamic set. - [GET /sets/{set_id}](https://docs.usewheelhouse.com/rm/reference/rm-get-set.md): Get a single dynamic set. - [POST /sets/{set_id}/upgrade](https://docs.usewheelhouse.com/rm/reference/rm-upgrade-set.md): Upgrade a dynamic set to a paid set. - [GET /sets/{set_id}/aggregated_metrics](https://docs.usewheelhouse.com/rm/reference/rm-get-set-aggregated-metrics.md): Get aggregated metrics for a dynamic set. - [GET /sets/{set_id}/listings](https://docs.usewheelhouse.com/rm/reference/rm-get-set-listings.md): List the listings in a dynamic set. - [PUT /sets/{set_id}/listings](https://docs.usewheelhouse.com/rm/reference/rm-put-set-listings.md): Add member listings to a dynamic set. - [DELETE /sets/{set_id}/listings](https://docs.usewheelhouse.com/rm/reference/rm-delete-set-listings.md): Remove member listings from a dynamic set. - [GET /sets/{set_id}/associated_listings](https://docs.usewheelhouse.com/rm/reference/rm-get-set-associated-listings.md): List the user listings associated with a dynamic set. - [PUT /sets/{set_id}/associated_listings](https://docs.usewheelhouse.com/rm/reference/rm-put-set-associated-listings.md): Associate user listings with a dynamic set. - [DELETE /sets/{set_id}/associated_listings](https://docs.usewheelhouse.com/rm/reference/rm-delete-set-associated-listings.md): Remove associated user listings from a dynamic set. - [GET /sets/{set_id}/price_calendar](https://docs.usewheelhouse.com/rm/reference/rm-get-set-price-calendar.md): Get the price calendar of a dynamic set's member listings. - [GET /sets/{set_id}/changelog](https://docs.usewheelhouse.com/rm/reference/rm-get-set-changelog.md): Get the changelog of a dynamic set. - [POST /sets/{set_id}/share](https://docs.usewheelhouse.com/rm/reference/rm-share-set.md): Share a dynamic set with other users. - [GET /sets/{set_id}/time_series](https://docs.usewheelhouse.com/rm/reference/rm-get-set-time-series.md): Get time-series metrics for a dynamic set. - [GET /sets/{set_id}/distribution](https://docs.usewheelhouse.com/rm/reference/rm-get-set-distribution.md): Get metric distributions for a dynamic set. ### [Notifications](https://docs.usewheelhouse.com/rm/reference/notifications.md) - [GET /notifications](https://docs.usewheelhouse.com/rm/reference/rm-get-notifications.md): List active notifications. - [POST /notifications/dismiss](https://docs.usewheelhouse.com/rm/reference/rm-dismiss-notifications.md): Dismiss notifications. - [GET /notification_settings](https://docs.usewheelhouse.com/rm/reference/rm-get-notification-settings.md): List notification alert settings. - [PUT /notification_settings](https://docs.usewheelhouse.com/rm/reference/rm-update-notification-settings.md): Configure notification alert settings. ### [Teams](https://docs.usewheelhouse.com/rm/reference/teams.md) - [GET /teams/members](https://docs.usewheelhouse.com/rm/reference/rm-get-team-members.md): List team members. - [POST /teams/members/invite](https://docs.usewheelhouse.com/rm/reference/rm-post-team-member-invite.md): Invite a team member. - [DELETE /teams/members/{sub_user_id}](https://docs.usewheelhouse.com/rm/reference/rm-delete-team-member.md): Remove a team member. - [POST /teams/members/{sub_user_id}/auto_managed_listing_level](https://docs.usewheelhouse.com/rm/reference/rm-post-team-member-auto-managed-listing-level.md): Set a team member's auto managed listing level. - [POST /teams/members/{sub_user_id}/assigned_segments](https://docs.usewheelhouse.com/rm/reference/rm-post-team-member-assigned-segments.md): Assign portfolio segments to a team member. - [POST /teams/members/{sub_user_id}/refresh_auto_managed_listings](https://docs.usewheelhouse.com/rm/reference/rm-post-team-member-refresh-auto-managed-listings.md): Refresh a team member's auto managed listing access. - [GET /teams/memberships](https://docs.usewheelhouse.com/rm/reference/rm-get-team-memberships.md): List team memberships. - [POST /teams/memberships/{master_user_id}](https://docs.usewheelhouse.com/rm/reference/rm-post-team-membership.md): Accept a team invitation. - [DELETE /teams/memberships/{master_user_id}](https://docs.usewheelhouse.com/rm/reference/rm-delete-team-membership.md): Leave a team, or decline an invitation. ### [Webhooks](https://docs.usewheelhouse.com/rm/reference/webhooks.md) - [GET /webhook_events](https://docs.usewheelhouse.com/rm/reference/rm-get-webhook-events.md): List subscribable event types. - [GET /webhooks](https://docs.usewheelhouse.com/rm/reference/rm-get-webhooks.md): List webhook subscriptions. - [POST /webhooks](https://docs.usewheelhouse.com/rm/reference/rm-create-webhook.md): Create a webhook subscription. - [GET /webhooks/{id}](https://docs.usewheelhouse.com/rm/reference/rm-get-webhook.md): Get a webhook subscription. - [PUT /webhooks/{id}](https://docs.usewheelhouse.com/rm/reference/rm-update-webhook.md): Update a webhook subscription. - [DELETE /webhooks/{id}](https://docs.usewheelhouse.com/rm/reference/rm-delete-webhook.md): Delete a webhook subscription. - [POST /webhooks/{id}/rotate_secret](https://docs.usewheelhouse.com/rm/reference/rm-rotate-webhook-secret.md): Rotate a webhook signing secret. - [GET /webhooks/{id}/deliveries](https://docs.usewheelhouse.com/rm/reference/rm-get-webhook-deliveries.md): List recent delivery attempts. ### [Usage](https://docs.usewheelhouse.com/rm/reference/usage.md) - [GET /usage](https://docs.usewheelhouse.com/rm/reference/rm-get-usage.md): Aggregated API usage for the authenticated user. ### [Feedback](https://docs.usewheelhouse.com/rm/reference/feedback.md) - [POST /feedback](https://docs.usewheelhouse.com/rm/reference/rm-post-feedback.md): Send feedback about the API.