---
title: "Returns a list of rates."
method: GET
path: "/rateplan/v1/rate-plans/{id}/rates"
tags: ["Rate"]
---

# Returns a list of rates.

`GET /rateplan/v1/rate-plans/{id}/rates`

## Request

- Base URL: `https://api.apaleo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.apaleo.com/rateplan/v1/rate-plans/{id}/rates`
- Auth: OAuth 2
  - Implicit: `https://identity.apaleo.com/connect/authorize`
  - Scopes: `rates.read`, `rates.manage`, `admin`

Returns all rates for a specific rate plan within the specified time range. If a rate has not
been initialized, it will still be returned, but anything besides the from and to values will be empty.
The time range of a rate is defined by the time slice definition of the rate plan.

Time ranges with no initialized rates will not be available for sell.


To be able to read rates for a corporate rate plan a client must additionally have
the 'rateplans.read-corporate' scope.<br>You must have at least one of these scopes: 'rates.read, rates.manage'.<br>For fine-grained clients, you must have this permission: 'core.rates.read'.

## Path parameters

- `id` string, required

## Query parameters

- `from` string, required
- `to` string, required
- `pageNumber` integer
- `pageSize` integer

## Response `200`

Return all rates for a rate plan.

- RateListModel
  - `rates` RateItemModel[], required: List of rates
    - `from` string, date-time, required: Date and time the rate begins<br />A date and time (without fractional second part) in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>
    - `to` string, date-time, required: Date and time the rate ends<br />A date and time (without fractional second part) in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>
    - `price` MonetaryValueModel
      - `amount` number, double, required
      - `currency` string, required
    - `includedServicesPrice` MonetaryValueModel
      - `amount` number, double, required
      - `currency` string, required
    - `calculatedPrices` CalculatedRateModel[], nullable: A list of prices for occupancies 2 or higher. Only set, if the rate plan defines surcharges for different occupancies
      - `adults` integer, required: Number of adults this rate is valid for
      - `price` MonetaryValueModel, required
        - `amount` number, double, required
        - `currency` string, required
      - `includedServicesPrice` MonetaryValueModel
        - `amount` number, double, required
        - `currency` string, required
    - `restrictions` RateRestrictionsModel
      - `minLengthOfStay` integer, nullable: The minimum length of stay in order to book the rate. If at least this number of time slices are covered by the stay duration the rate will be offered.
      - `maxLengthOfStay` integer, nullable: The maximum length of stay in order to book the rate. If not more than this number of time slices are covered by the stay duration the rate will be offered.
      - `closed` boolean, required: Whether the rate can be booked for a stay-through reservation
      - `closedOnArrival` boolean, required: Whether the rate can be booked on the reservation's arrival date
      - `closedOnDeparture` boolean, required: Whether the rate can be booked on the reservation's departure date
  - `count` integer, required: Total count of items

## Other responses

- `204`: There are no rates found.
- `400`: Bad request.
- `401`: You are unauthorized.
- `403`: Forbidden.
- `404`: The Request-URI could not be found.
- `422`: Validation errors in the request body or query params.
- `499`: Client closed request.
- `500`: An unexpected error occurred.
- `503`: The server is currently unavailable. Please try later.

---

[API](https://skmtc.dev/apaleo/apis/apaleo-rate-plan-api.md) - [All operations](https://skmtc.dev/apaleo/apis/apaleo-rate-plan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/apaleo/apis/apaleo-rate-plan-api/revisions/9c4f5fec8ed5?raw)