# Get base price recommendation options for a listing.

`GET /listings/{listing_id}/base_price_recommendation`

> Wheelhouse Revenue Management API. Web version: https://docs.usewheelhouse.com/rm/reference/rm-get-base-price-recommendation · OpenAPI spec: https://docs.usewheelhouse.com/rm/openapi.yaml · Operation ID: `rmGetBasePriceRecommendation` · Tag: Recommendations

Returns recommended, conservative, and aggressive base prices, the listing's active base price, anchoring
fields (`anchor_price`, `anchor_credibility`), and a consolidated `base_price_attribution` object aligned with
the Wheelhouse app Recommended Breakdown.

## Request

`GET https://api.usewheelhouse.com/ss_api/v1/listings/{listing_id}/base_price_recommendation`

Authentication: send your RM API key in the `X-Integration-Api-Key` header (see https://docs.usewheelhouse.com/rm/authentication.md). Read-only keys can call this endpoint.

### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `listing_id` | string | yes | The channel's unique listing identifier, or the Wheelhouse listing ID when `channel` is `wheelhouse`. |

### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `channel` | string | yes | Channel name the listing is on (the `channel` field of the [/listings](https://docs.usewheelhouse.com/rm/reference/rm-get-listings.md) response), or the literal `wheelhouse` to read `listing_id` as a Wheelhouse listing ID instead. See [Identifying Listings](https://docs.usewheelhouse.com/rm/concepts/listings.md). |
| `currency` | string | no | ISO-4217 3-letter currency code (e.g. 'USD', 'GBP') to convert prices to. Uses listing's currency by default. |

### Example request

```bash
curl -X GET 'https://api.usewheelhouse.com/ss_api/v1/listings/{listing_id}/base_price_recommendation?channel=<channel>' \
  -H 'X-Integration-Api-Key: <your RM API key>'
```

Only required parameters and body fields are filled in, with placeholder values. Add the optional ones you need from the lists above; some are required in combination, as their descriptions say.

## Responses

### 200

Base price recommendation options and breakdown.

Body (`application/json`): object `base_price_recommendation`

Recommended and selected base prices, anchoring context, and a consolidated attribution breakdown. Monetary
fields use the response `currency` (listing currency by default, or the `currency` query parameter); amounts
are converted from the listing market currency inside Wheelhouse.

- `base_price_recommended` (integer, required): Recommended base nightly price.
- `base_price_conservative` (integer, required): Conservative variant.
- `base_price_aggressive` (integer, required): Aggressive variant.
- `base_price_selected` (integer, required): The base price in use for the listing, which its price recommendations are computed from. This is the manual `base_price` from `GET /preferences/{listing_id}` when one is set (converted to this response's `currency` when that differs), otherwise `base_price_recommended` multiplied by the preference `base_price_adjustment`. Unlike the preference `base_price`, it is never `null`.
- `anchor_credibility` (number, required, min: 0, max: 100): Effective anchoring strength as a percentage. Reflects how much observed booking history is
  incorporated into the base price recommendation (aligns with "credibility" in the Wheelhouse app).

  - **0%**: No usable booking data — new listing, no qualifying bookings in the past 2 years, or anchoring disabled.
  - **~90% (typical maximum)**: Full booking history available.
  - **Intermediate values**: Ramps linearly with booking volume (approaching full weight around 30 effective
    booked nights over 2 years) and booking distribution uniformity across the calendar year.

  Higher values mean the base price is more influenced by the listing's own historical booking prices and
  less by the market model. See `base_price_attribution.observed_bookings` for the dollar-amount
  contribution anchoring adds to the recommendation.
- `anchor_price` (integer, required, nullable): Median observed booking price used in anchoring, when available.
- `base_price_attribution` (object `base_price_attribution`, required): Consolidated signed amounts (in the response `currency`) for the Wheelhouse recommended base price
  breakdown, grouped to match the in-app "Recommended Breakdown" rows. Values are integers (rounded).
  - `market_baseline` (integer, required): Market-wide average listing price.
  - `bedrooms_bathrooms` (integer, required): Combined impact of bedroom and bathroom count.
  - `room_type` (integer, required): Room / listing type impact.
  - `guests` (integer, required): Combined impact of sleeps, extra guest fee, and included-guests positioning.
  - `location` (integer, required): Location specific impact.
  - `amenities_fees` (integer, required): Combined impact of amenities, cleaning fee, photo count, and security deposit.
  - `occupancy` (integer, required): Impact of occupancy positioning vs market.
  - `observed_bookings` (integer, required): Effect of observed median booking price vs the pure model price.
- `currency` (string, required): ISO-4217 code all monetary amounts are expressed in.

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "base_price_recommended": 0,
  "base_price_conservative": 0,
  "base_price_aggressive": 0,
  "base_price_selected": 0,
  "anchor_credibility": 0,
  "anchor_price": 0,
  "base_price_attribution": {
    "market_baseline": 0,
    "bedrooms_bathrooms": 0,
    "room_type": 0,
    "guests": 0,
    "location": 0,
    "amenities_fees": 0,
    "occupancy": 0,
    "observed_bookings": 0
  },
  "currency": "string"
}
```

### 401

API key authorization failed.

### 403

Listing authorization failed.

### 404

Listing not found.

### 406

The listing is inactive. See the **Inactive Listings** section in the overview.

Body (`application/json`): object

- `error` (string, example: `Listing '12345' is inactive`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "Listing '12345' is inactive"
}
```

### 422

Listing is not covered by a Wheelhouse market.

### 429

Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the **Rate Limits** section in the overview for the recommended exponential backoff strategy.

Body (`application/json`): object

- `error` (string, example: `API token is at rate limit`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "API token is at rate limit"
}
```
