APapaleo
Rate

Returns a list of rates for multiple rate plans.

Returns all rates for multiple rate plans 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'.

get/rateplan/v0-nsfw/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/v0-nsfw/rates
  • Auth
    OAuth 2
    Implicit: https://identity.apaleo.com/connect/authorize
    Scopes: rates.read, rates.manage, admin

Query parameters

propertyIdstring required

The id of the property.

ratePlanIdsstring[] required

The rate plan ids. At most 50 ids can be specified.

fromstring required

The start of the time range to filter the rates by. All rates where the from date and time is equal or later than the specified date and optional time will be affected. The specified time range cannot span more than 60 days.<br />Specify either a pure date or 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>

tostring required

The end of the time range to filter the rates by. All rates where the from date and time is earlier than the specified date and optional time will be affected. The specified time range cannot span more than 60 days.<br />Specify either a pure date or 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>

Response

Return all rates for a rate plan.

countinteger required

Total count of items

Example response

{
  "rates": [
    {
      "ratePlanId": "MUC-NONREF_SGL",
      "from": "2026-10-09T17:00:00+02:00",
      "to": "2026-10-10T11:00:00+02:00",
      "price": {
        "amount": 100,
        "currency": "EUR"
      },
      "restrictions": {
        "closed": false,
        "closedOnArrival": false,
        "closedOnDeparture": false
      }
    },
    {
      "ratePlanId": "MUC-NONREF_DBL",
      "from": "2026-10-09T17:00:00+02:00",
      "to": "2026-10-10T11:00:00+02:00",
      "price": {
        "amount": 123,
        "currency": "EUR"
      },
      "calculatedPrices": [
        {
          "adults": 2,
          "price": {
            "amount": 133,
            "currency": "EUR"
          }
        }
      ],
      "restrictions": {
        "minLengthOfStay": 2,
        "maxLengthOfStay": 30,
        "closed": false,
        "closedOnArrival": true,
        "closedOnDeparture": true
      }
    }
  ],
  "count": 0
}

Changes

No recorded changes to this operation across all 4 revisions of this API.