> For the complete documentation index, see [llms.txt](https://docs.rateparity.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rateparity.com/rates/lowest-rates.md).

# Lowest Monthly Rates

<mark style="color:blue;">`GET`</mark> `https://api.rateparity.com/v1/rate/lowestmonthly/{code}`

Returns, for each month in the forecast horizon, the lowest direct rate found on the hotel website, along with:

* **month** – the month (1–12) the rate belongs to
* **year** – the calendar year of that month
* **rate** – the lowest nightly rate found for that month
* **day** – the specific date for which this lowest rate applies
* **minStay** – the minimum length of stay (in nights) required for that rate
* **timestamp** – when this lowest rate was last fetched

#### Path Parameters

| Name                                   | Type   | Description        |
| -------------------------------------- | ------ | ------------------ |
| code<mark style="color:red;">\*</mark> | String | The property code. |

{% tabs %}
{% tab title="200: OK Everything worked as expected" %}
{% code lineNumbers="true" %}

```json
{
  "data": {
    "hotelCode": "WOLAWARSAW",
    "currency": "PLN",
    "lowestMonthlyRates": [
      {
        "month": 12,
        "year": 2025,
        "rate": 210.0,
        "day": "2025-12-07T02:00:00",
        "minStay": 28,
        "timestamp": "2025-11-25T14:13:01.000+00:00"
      },
      {
        "month": 1,
        "year": 2026,
        "rate": 262.5,
        "day": "2026-01-11T02:00:00",
        "minStay": 1,
        "timestamp": "2025-11-25T14:13:03.000+00:00"
      },
      {
        "month": 2,
        "year": 2026,
        "rate": 262.5,
        "day": "2026-02-01T02:00:00",
        "minStay": 1,
        "timestamp": "2025-11-25T14:13:05.000+00:00"
      },
      {
        "month": 3,
        "year": 2026,
        "rate": 262.5,
        "day": "2026-03-01T02:00:00",
        "minStay": 1,
        "timestamp": "2025-11-25T14:13:07.000+00:00"
      },
      {
        "month": 4,
        "year": 2026,
        "rate": 241.5,
        "day": "2026-04-05T03:00:00",
        "minStay": 1,
        "timestamp": "2025-11-25T14:13:10.000+00:00"
      },
      {
        "month": 5,
        "year": 2026,
        "rate": 241.5,
        "day": "2026-05-10T03:00:00",
        "minStay": 1,
        "timestamp": "2025-11-25T14:13:12.000+00:00"
      },
      {
        "month": 6,
        "year": 2026,
        "rate": 241.5,
        "day": "2026-06-07T03:00:00",
        "minStay": 1,
        "timestamp": "2025-11-25T14:13:14.000+00:00"
      },
      {
        "month": 7,
        "year": 2026,
        "rate": 258.75,
        "day": "2026-07-05T03:00:00",
        "minStay": 1,
        "timestamp": "2025-11-25T14:13:16.000+00:00"
      },
      {
        "month": 8,
        "year": 2026,
        "rate": 258.75,
        "day": "2026-08-02T03:00:00",
        "minStay": 1,
        "timestamp": "2025-11-25T14:13:18.000+00:00"
      },
      {
        "month": 9,
        "year": 2026,
        "rate": 241.5,
        "day": "2026-09-06T03:00:00",
        "minStay": 1,
        "timestamp": "2025-11-25T14:13:20.000+00:00"
      },
      {
        "month": 10,
        "year": 2026,
        "rate": 241.5,
        "day": "2026-10-04T03:00:00",
        "minStay": 1,
        "timestamp": "2025-11-25T14:13:22.000+00:00"
      }
    ]
  }
}
```

{% endcode %}
{% endtab %}

{% tab title="400: Bad Request Invalid parameters (e.g. invalid property code or date configuration)" %}

```json
{
  "timestamp": "2025-11-25T14:13:22",
  "message": "Data provided is invalid"
}
```

{% endtab %}

{% tab title="401: Unauthorized No valid API key provided or not authorised to access the provided property code" %}

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

<pre><code><strong>curl 'https://api.rateparity.com/v1/rate/lowestmonthly/WOLAWARSAW' \
</strong><strong>--header 'Authorization: Bearer YOUR_API_KEY'
</strong></code></pre>

{% endtab %}
{% endtabs %}