# Get the base price recommendation history for a listing.

`GET /listings/{listing_id}/base_price_history`

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

Returns a daily log of Wheelhouse base price recommendations and settings for the listing. Each record reflects the model's recommendation, any adjustments applied, and the effective base price used on that day.

Defaults to the last 30 days when `start_date` and `end_date` are omitted.

## Request

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

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). |
| `start_date` | string (date) | no | First model date to include (YYYY-MM-DD). Defaults to 30 days before `end_date`. |
| `end_date` | string (date) | no | Last model date to include (YYYY-MM-DD). Defaults to today. |

### Example request

```bash
curl -X GET 'https://api.usewheelhouse.com/ss_api/v1/listings/{listing_id}/base_price_history?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

Array of base price history entries ordered by model_date.

Body (`application/json`): array of object

- `model_date` (string (date)): The date this recommendation was computed.
- `raw_recommendation` (integer, nullable): The raw model recommendation before any anchoring adjustments.
- `recommendation` (integer, nullable): The anchored base price recommendation.
- `adjustment` (number (float), nullable): Multiplicative adjustment factor applied by the user (e.g. 1.1 for +10%).
- `fixed` (integer, nullable): The user-set fixed base price, if any. When present, this overrides the recommendation.
- `anchor_price` (integer, nullable): The anchor price used to blend the model recommendation.
- `anchor_weight` (number (float), nullable): The weight given to the anchor price (0–1).
- `effective_base_price` (number (float), nullable): The base price that was actually in effect — equal to `fixed` when set, otherwise `recommendation * adjustment`.

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

```json
[
  {
    "model_date": "2026-01-01",
    "raw_recommendation": 0,
    "recommendation": 0,
    "adjustment": 0,
    "fixed": 0,
    "anchor_price": 0,
    "anchor_weight": 0,
    "effective_base_price": 0
  }
]
```

### 400

`end_date` is before `start_date`.

### 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"
}
```

### 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"
}
```
