Offer

Returns service offers for one specific stay.

<br>You must have at least one of these scopes: 'offers.read, reservations.manage'.<br>For fine-grained clients, you must have this permission: 'core.offers.read'.

get/booking/v0-nsfw/service-offers

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/booking/v0-nsfw/service-offers
Auth
OAuth 2
Implicit: https://identity.apaleo.com/connect/authorize
Scopes: offers.read, reservations.manage, admin

Query parameters

ratePlanIdstring required

The rate plan ID

arrivalstring required

Date and optional time of arrival<br />Specify either a pure date or a date and time in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>

departurestring required

Date and optional time of departure. Cannot be more than 5 years after arrival.<br />Specify either a pure date or a date and time in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>

The channel code used to filter the services

adultsinteger required

The number of adults you want offers for

childrenAgesinteger[]

The ages of the children you want offers for

onlyDefaultDatesboolean

Depending on the postNextDay setting of a service it will be posted before or after midnight. Breakfast is usually delivered on the next morning, having 'postNextDay' set to true. Its 'default dates' are from the day after arrival until the departure day. For services like dinner 'postNextDay' is false, and default dates are day of arrival until one day before departure. With this query parameter set to 'false', you can also ask for dates outside of those default dates. It defaults to true.

includeUnavailableboolean

Return also offers that are currently not publicly bookable as restrictions are violated. By default only available offers are returned

Response

Success.

Example response

{
  "services": [
    {
      "service": {
        "id": "MUC-WLAN",
        "code": "WLAN",
        "name": "High-Speed WLAN",
        "description": "Upgrade the complimentary internet access to a high speed connection.",
        "pricingUnit": "Room",
        "defaultGrossPrice": {
          "amount": 5,
          "currency": "EUR"
        }
      },
      "count": 1,
      "availableCount": 2,
      "totalAmount": {
        "grossAmount": 20,
        "netAmount": 16.8,
        "vatType": "Normal",
        "vatPercent": 19,
        "currency": "EUR"
      },
      "prePaymentAmount": {
        "amount": 20,
        "currency": "EUR"
      },
      "dates": [
        {
          "serviceDate": "2026-10-30",
          "amount": {
            "grossAmount": 10,
            "netAmount": 8.4,
            "vatType": "Normal",
            "vatPercent": 19,
            "currency": "EUR"
          },
          "isDefaultDate": false,
          "isMandatory": false,
          "availableCount": 5
        },
        {
          "serviceDate": "2026-10-31",
          "amount": {
            "grossAmount": 10,
            "netAmount": 8.4,
            "vatType": "Normal",
            "vatPercent": 19,
            "currency": "EUR"
          },
          "isDefaultDate": false,
          "isMandatory": false,
          "availableCount": 2
        }
      ]
    },
    {
      "service": {
        "id": "MUC-YOGA",
        "code": "YOGA",
        "name": "Sun Salutation",
        "description": "Start the day with a private Yoga session with one of our certified trainers.",
        "pricingUnit": "Person",
        "defaultGrossPrice": {
          "amount": 35,
          "currency": "EUR"
        }
      },
      "count": 1,
      "totalAmount": {
        "grossAmount": 30,
        "netAmount": 25.21,
        "vatType": "Normal",
        "vatPercent": 19,
        "currency": "EUR"
      },
      "prePaymentAmount": {
        "amount": 30,
        "currency": "EUR"
      },
      "dates": [
        {
          "serviceDate": "2026-10-31",
          "amount": {
            "grossAmount": 30,
            "netAmount": 25.21,
            "vatType": "Normal",
            "vatPercent": 19,
            "currency": "EUR"
          },
          "isDefaultDate": false,
          "isMandatory": false,
          "taxes": [
            {
              "taxDefinitionCode": "WELLNESS-TAX",
              "amount": {
                "grossAmount": 2,
                "netAmount": 2,
                "vatType": "Without",
                "vatPercent": 0,
                "currency": "EUR"
              },
              "remittedBy": "Hotel"
            }
          ]
        }
      ]
    }
  ]
}

Changes

No operation changes recorded.