# Get recommended monthly seasonality adjustment factors for a listing.

`GET /listings/{listing_id}/monthly_seasonality`

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

Returns conservative (CON), recommended (REC), and aggressive (AGG) seasonality multipliers
grouped by month number (1–12).

The factors represent the average seasonality multiplier for each month based on
market data and can be used to understand seasonal pricing patterns.

A factor of 1.0 means no seasonal adjustment, values above 1.0 indicate higher
demand periods, and values below 1.0 indicate lower demand periods.

The three levels differ in how much they amplify the seasonality signal:
- CON: 80% of the base seasonality variation
- REC: 100% of the base seasonality variation
- AGG: 120% of the base seasonality variation

## Request

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

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). |

### Example request

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

Monthly seasonality factors.

Body (`application/json`): object

Object with keys `CON`, `REC`, and `AGG`, each mapping month numbers (as strings, "1"–"12") to a seasonality multiplier.

- `CON` (object `monthly_seasonality_factors`): Conservative seasonality factors by month number.

  Seasonality factor multipliers by calendar month (string keys "1" through "12").
  - Fields: see `monthly_seasonality_factors` under Schemas.
- `REC` (object `monthly_seasonality_factors`): Recommended seasonality factors by month number.

  Seasonality factor multipliers by calendar month (string keys "1" through "12").
  - Fields: see `monthly_seasonality_factors` under Schemas.
- `AGG` (object `monthly_seasonality_factors`): Aggressive seasonality factors by month number.

  Seasonality factor multipliers by calendar month (string keys "1" through "12").
  - Fields: see `monthly_seasonality_factors` under Schemas.

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

```json
{
  "CON": {
    "1": 0,
    "2": 0,
    "3": 0,
    "4": 0,
    "5": 0,
    "6": 0,
    "7": 0,
    "8": 0,
    "9": 0,
    "10": 0,
    "11": 0,
    "12": 0
  },
  "REC": {
    "1": 0,
    "2": 0,
    "3": 0,
    "4": 0,
    "5": 0,
    "6": 0,
    "7": 0,
    "8": 0,
    "9": 0,
    "10": 0,
    "11": 0,
    "12": 0
  },
  "AGG": {
    "1": 0,
    "2": 0,
    "3": 0,
    "4": 0,
    "5": 0,
    "6": 0,
    "7": 0,
    "8": 0,
    "9": 0,
    "10": 0,
    "11": 0,
    "12": 0
  }
}
```

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

## Schemas

Shared by more than one field above.

### `monthly_seasonality_factors`

Type: object `monthly_seasonality_factors`

Seasonality factor multipliers by calendar month (string keys "1" through "12").

- `1` (number): The seasonality factor for January.
- `2` (number): The seasonality factor for February.
- `3` (number): The seasonality factor for March.
- `4` (number): The seasonality factor for April.
- `5` (number): The seasonality factor for May.
- `6` (number): The seasonality factor for June.
- `7` (number): The seasonality factor for July.
- `8` (number): The seasonality factor for August.
- `9` (number): The seasonality factor for September.
- `10` (number): The seasonality factor for October.
- `11` (number): The seasonality factor for November.
- `12` (number): The seasonality factor for December.
