Meal plan inclusions

Understand more about how meal plan inclusions are returned in the API.

How meal plan inclusions are returned in the API

Meal plans can be returned on different levels, which has an important impact on their meaning. They can be returned as a rate amenity, a property amenity, as content or, in some instances, as a value add promotion. For the full list of rate and property amenities see the content reference lists.

Rate plan amenities

Note: Rate amenities may also be seen in the content response. However, for the most up-to-date information regarding rate amenities, partners should take the meal inclusion and other rate amenities from the Shop response rather than the Content response.

In the content reference lists these are listed under amenities_rates.

Some common ones are:

  • 1073742786 - Free breakfast
  • 2194 - Breakfast for 2
  • 2205 - Breakfast buffet
  • 2206 - Half board
  • 2111 - All-inclusive

The rate plan amenities can be seen in the Rapid Availability response. Unless there is a number specified such as 'Breakfast for 2' then the meal should be included for all guests in the booking.

"amenities": {
                            "1073742857": {
                                "id": "1073742857",
                                "name": "Breakfast for 1"
                            },
                            "1073742617": {
                                "id": "1073742617",
                                "name": "Disney park tickets"
                            },
                            "2192": {
                                "id": "2192",
                                "name": "Free WiFi"
                            }
                        },

Rate plan amenities can also be seen in Rapid Itinerary Retrieve response:

"rate": {
"id": "384339493",
"merchant_of_record": "expedia",
"refundable": true,
"amenities": [
"2109",
"2192",
"1073742786"
                ],

Property amenities

In the content reference lists these are listed under amenities_property.

The property amenities can be seen in the Rapid Content response:

"amenities": {
            "2387": {
                "id": "2387",
                "name": "Tours/ticket assistance"
            },
            "4467": {
                "id": "4467",
                "name": "Beach towels"
            },
            "56": {
                "id": "56",
                "name": "Airport transportation (surcharge)"
            },
            "4003": {
                "id": "4003",
                "name": "Luggage storage"
            },
            "2001": {
                "id": "2001",
                "name": "Free breakfast"
            },
            "2386": {
                "id": "2386",
                "name": "Grocery/convenience store"
            }
        },

The 2001 'free breakfast' property amenity means that a complimentary breakfast is included with all rooms and rate plans for the property. This is replicated at the rate level in the Rapid Shop response as attribute 1073742786 'free breakfast'. Note that unlike the rate plan amenities, which show what is included with a rate plan, the property amenity shows what is available at the property but is not necessarily free, for example attribute 361 'breakfast available (surcharge)'.

All-inclusive

A property may have some, or all, all-inclusive rate plans. These details are in the all_inclusive section of the Rapid Content response.

All rate plans are all-inclusive

If all_rate_plans: true then all rate plans for the property are all-inclusive, even if there is no rate plan amenity 'all-inclusive'.

"all_inclusive": {
            "all_rate_plans": true,
            "details": "This property is all-inclusive. Onsite food and beverages are included in the room price (some restrictions may apply).  <strong>Gratuities and taxes</strong>
Gratuities and taxes are included. Additional gratuities at guests' discretion are accepted.  <strong>Food and beverages</strong><ul><li>All buffet and à la carte meals, snacks, and beverages included</li><li>In-room minibar (some restrictions)</li><li>Limited gourmet or à la carte dining</li></ul> <strong>Activities and facilities/equipment</strong>
All non-motorized water sports, land activities, and use of recreational facilities and equipment are included. 
Water activities<ul><li>Snorkeling</li><li>Windsurfing</li></ul>
Land activities<ul><li>Bicycling</li><li>Fitness facilities</li><li>Tennis</li><li>Tennis lessons</li><li>Volleyball</li><li>Access to golf course</li></ul>
Lessons/classes/games <ul><li>Aerobics</li><li>Dancing</li><li>Language</li></ul> <strong>Kids' club</strong><ul><li>Supervised activities for children between 4 and 12 years old</li></ul> <strong>Not included</strong><ul><li>Golf green fees</li><li>Use of golf cart</li><li>Use of golf equipment</li><li>Motorized water sports</li><li>Scuba-diving certification</li><li>Tennis racquets</li><li>Premium food items</li><li>Premium/non-domestic alcoholic beverages</li><li>Childcare</li><li>Spa/beauty facilities and services</li></ul>",
            "some_rate_plans": false
        },)

Other indicators that all rate plans are all-inclusive are 'all inclusive' in the property name. Expedia Group does not sell a property with 'all inclusive' in the property name if not all rate plans are all-inclusive for that property. Also, the property category in the Content response may show property category 8 'All-inclusive Property'. See a full list of property categories here.

Some rate plans are all-inclusive

If some_rate_plans: true then those rate plans which are all inclusive will have rate plan amenity 2111 'all-inclusive'. It will not have 'all inclusive' in the hotel name or the property category 'all-inclusive property'.

Restrictions for all-inclusive

Restrictions for all-inclusive, for example where alcoholic beverages are not included in the rate plan, can be seen in the details value of the all_inclusive response.

Example:

"all_inclusive": {
            "all_rate_plans": false,
            "details": "<em>All-inclusive</em> room rates at Solymar Naama Bay are available. These rates are higher because they include onsite food and beverages in the room rate (some restrictions may apply).  <strong>Gratuities and taxes</strong>
Gratuities and taxes are included. Additional gratuities at guests' discretion are accepted.  <strong>Food and beverages</strong><ul><li>Buffet meals, snacks, and select beverages included</li><li>Basic alcoholic beverages included</li><li>Dining availability limited at one or more venues</li></ul> <strong>Activities and facilities/equipment</strong>
Lessons/classes/games <ul><li>Dancing</li></ul> <strong>Entertainment</strong><ul><li>Onsite entertainment and activities</li></ul> <strong>Not included</strong><ul><li>Motorized water sports</li><li>Premium/non-domestic alcoholic beverages</li><li>Activities and services offered by independent operators</li></ul>",
            "some_rate_plans": true

Value add promotions

Meal inclusion may also, in some instances, be seen in the Shop response as a value add promotion.

Example:

"promotions": {
"value_adds": {
"287248": {
"id": "287248",
"description": "Free dinner for 2 per day",
"category": "food_and_beverage",
"offer_type": "free",
"frequency": "per_day",
"person_count": 2
                                }
                            }
                        }

Value add promotions can also be seen in Rapid Itinerary Retrieve response.

Example:

"rate": {
"id": "209136450",
"merchant_of_record": "expedia",
"refundable": true,
"amenities": [
"2192"
                ],
"promotions": {
"value_adds": {
"279553": {
"id": "279553",
"description": "Free continental breakfast for 2 per day",
"category": "food_and_beverage",
"offer_type": "free",
"frequency": "per_day",
"person_count": 2
                        }
                    }
                },

Special value adds

Rate plans that are part of a special offer may have rate level content that includes additional information and restrictions on the offer. This is listed in the free text field special_offer_description that is returned in the Content response.

Example:

"201510380": {
              "id": "201510380",
              "amenities": {
                  "2191": {
                      "id": "2191",
                      "name": "Free high-speed internet"
                  },
                  "2194": {
                      "id": "2194",
                      "name": "Breakfast for 2"
                  },
                  "2109": {
                      "id": "2109",
                      "name": "Free self parking"
                  },
                  "2192": {
                      "id": "2192",
                      "name": "Free WiFi"
                  }
              },
              "special_offer_description": "<strong>Stay for Breakfast</strong>
Book a stay in this rate plan and receive breakfast for 2 adults and children under 12 years old registered in the same room. 
<em>Full details at check-in. Restrictions may apply.</em>"
          },
Did you find this page helpful?
How can we improve this content?
Thank you for helping us improve!