# List the price models customers can pick from.

`GET /price_models`

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

Returns the price models customers can pick from, the current one first. The current model prices every listing that has not picked another one, unless its channel or market is set to a different model. Pass a model's `id` as `price_model_id` to [GET /listings/{listing_id}/price_recommendations](https://docs.usewheelhouse.com/rm/reference/rm-get-price-recommendations.md) or [POST /preferences/{listing_id}/preview](https://docs.usewheelhouse.com/rm/reference/rm-preview-preferences.md) to price with it; a model that has not run for a listing's market returns `400` there.

## Request

`GET https://api.usewheelhouse.com/ss_api/v1/price_models`

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.

### Example request

```bash
curl -X GET 'https://api.usewheelhouse.com/ss_api/v1/price_models' \
  -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

Available price models.

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

- `id` (integer): Price model ID, to pass as `price_model_id`.
- `name` (string)
- `version` (number)
- `display_name` (string): Name and version, e.g. `Blended model v9.0`.
- `status` (string, one of: `current`, `opt_in`): `current` for the model listings get when nothing else is set, `opt_in` for an alternative.
- `description` (string, nullable): How the model prices, in plain language.

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

```json
[
  {
    "id": 0,
    "name": "string",
    "version": 0,
    "display_name": "string",
    "status": "current",
    "description": "string"
  }
]
```

### 401

API key authorization failed.

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