Changelog

Loyalty - Book | Shop | Feature | V3

We are adding new features that increase your ability to locate business rates that have property loyalty earn opportunities associated with them. Read more about our Hotel Loyalty Points.

Benefit:

Partners will have better tools to help their business travelers earn points in property loyalty programs.

Marketing Fee Incentives - Shop | Feature | V3

Added a new value to the Shop request for the include parameter, which will cause the marketing_fee_incentives object to be returned in the response.

Rapid 3 Request Example:

curl -X GET "https://test.ean.com/v3/properties/availability\
?checkin=2024-01-01\
&checkout=2024-01-03\
&currency=USD\
&country_code=US\
&language=en-US\
&occupancy=2\
&property_id=19248\
&rate_plan_count=1\
&sales_channel=website\
&sales_environment=hotel_only\
&include=rooms.rates.marketing_fee_incentives\
&travel_purpose=leisure" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Rapid 3 Response Example:

[
  {
    "property_id": "19248",
    "status": "available",
    "rooms": [
      {
        "id": "123abc",
        "room_name": "Fancy Queen Room",
        "rates": [
          {
            "id": "333abc",
            "status": "available",
            ...
            "marketing_fee_incentives": [
              {
                "source": "property",
                "start": "2024-01-01",
                "end": "2024-01-01"
              }
            ],
            ...
          }
        ]
      }
    ],
    "links": { ... },
    "score": 10052
  }
]

Benefit:

Partners will be able to more easily identify rates that have special incentives applied.

New Search and Filter Options - Content | Feature | V3

We've added new request parameters that enable you to narrow your search results by these fields:

• all_inclusive
• amenity_id
• attribute_id
• category_id
• spoken_language_id

In addition, we have made it possible to specify with much more significant granularity which portions of the response you want to be included, by increasing the number of valid values for the include parameter. The new values include all top level elements of the Content response. Please see Search and filter for more information.

Rapid 3 Request Example: In this example we're using the new amenity_id search parameter, and the new values of name and amenities in the include parameter.

curl -X GET "https://test.ean.com/v3/properties/content\
?language=en-US\
&supply_source=expedia\
&amenity_id=115\
&include=name\
&include=amenities\
&property_id=1337\
&property_id=1" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Rapid 3 Response Example: In this response, we can see that only property 1337 is returned, because property 1 does not have amenity id 115 available. We can also see that property_id, name, and amenities are included in the response. property_id is always included in the response, and does not need to be specified as an include request parameter unless it is the only field desired in the response.

{
  "1337": {
    "property_id": "1337",
    "name": "Hyatt Regency Paris Etoile",
    "amenities": {
      "8": {
        "id": "8",
        "name": "Elevator"
      },
      "43": {
        "id": "43",
        "name": "Concierge services"
      },
      "115": {
        "id": "115",
        "name": "Bicycle rentals nearby"
      },
      "361": {
        "id": "361",
        "name": "Breakfast available (surcharge)"
      },
      ...
    }
  }
}

Benefit:

Partners seeking more specific properties, and more specific response fields can now optimize their interactions with the Rapid Content API. By specifying which pieces of content are needed, partners also communicate to the Rapid teams which Content is used and therefore valuable to partners.

Mobile Promotion Sale Scenario - Shop | Feature | V3

Added the value sale_scenario.mobile_promotion value to the include parameters for availability and shop for change requests.

Added the room.rate.sale_scenario.mobile_promotion field to the availability, additional rates, and shop for change responses.

Rapid 3 Request Example:

curl -X GET "https://test.ean.com/v3/properties/availability\
?checkin=2024-01-01\
&checkout=2024-01-03\
&currency=USD\
&country_code=US\
&language=en-US\
&occupancy=2\
&property_id=19248\
&rate_plan_count=1\
&sales_channel=mobile_app\
&sales_environment=hotel_only\
&include=sale_scenario.mobile_promotion\
&travel_purpose=leisure" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Rapid 3 Response Example:

[
  {
    "property_id": "19248",
    "status": "available",
    "rooms": [
      {
        "id": "123abc",
        "room_name": "Fancy Queen Room",
        "rates": [
          {
            "id": "333abc",
            "status": "available",
            ...
            "sale_scenario": {
              "package": false,
              "member": false,
              "corporate": false,
              "distribution": false,
              "mobile_promotion": false
            },
            ...
          }
        ]
      }
    ],
    "links": { ... },
    "score": 10052
  }
]

Benefit:

Partners seeking to more easily identify which rates have an associated mobile promotion deal will have a new method for accomplishing this.

New Bus Station Region Type - Geography | Feature | V3

Added the bus_station region type to the request for Regions endpoints. Both Region and Regions will now provide data about regions with the bus_station type.

Rapid 3 Request Example:

curl -X GET "https://test.ean.com/v3/regions\
?include=standard\
&language=en-US\
&supply_source=expedia\
&type=bus_station" \
 -H "Accept: application/json" \
 -H "Authorization: EAN apikey=1234,signature=14140287ea6ea1396b18b,timestamp=1697826383" \
 -H "Accept: application/json" \
 -H "Accept-Encoding: gzip" \
 -H "User-Agent: TravelNow/3.30.112"

Rapid 3 Response Example:

[
  {
    "id": "11234754",
    "type": "bus_station",
    "name": "Port Authority Bus Terminal",
    "name_full": "Port Authority Bus Terminal",
    "country_code": "US"
  }
]

Benefit:

Partners can include bus station information on their site for travelers.

Vacation Rental IPM Name in Content - Content | Feature | V3

Added the vacation_rental_details.ipm_name field to the Property Content response.

Rapid 3 Response Example:

{
  "4687248": {
    "property_id": "4687248",
    "name": "Beautiful 6 Bedroom Home With Two Pools, Only 10 minutes To Theme Park!",
    "address": { ... },
    ...
    "fees": {
      "traveler_service": "Your credit card statement will show two separate charges, one for the booking amount and property fees and another for the service fee. Both will be charged by Expedia partner Good Company.. The traveler service fee is refundable only when your entire booking is fully refundable. Please refer to the terms and conditions for the rules applicable to the booking facilitation services provided."
    },
    "attributes": { ... },
    ...
    "vacation_rental_details": {
      "private_host": true,
      ...
      "vrbo_srp_id": "334.3634257.3458973",
      "listing_id": "1252577",
      "listing_number": "3834275",
      "listing_source": "VRBO",
      "listing_unit": "/units/0001/429ecad2-bade-429a-a427-8adee57420ec",
      "ipm_name": "Good Company",
      "unit_configurations": { ... },
      "enhanced_house_rules": { ... },
      "free_text": "Stunning brand new 2-story home with 6 bedrooms, 4 bathrooms, brand new appliances/furniture, game room, grill, patio, and beautiful scenery all around. Minutes from Super Cool Lake. This place is the perfect getaway for a larger group whether it be a golf trip, lake trip, or time to gather with the family. Please note this property has two parking stalls, in addition to first come first serve overflow parking in the community. Celebrating something special? Birthday, Anniversary, Bachelor/Bachelorette, etc? We also offer decorating services for an extra fee. Please inquire within! This home features a fully-equipped kitchen for preparing meals, onsite washer and dryer and most importantly a private space, much larger than a hotel room for private family time away from crowds and people. We have a self-check-in and check-out system to limit your contact with people as well. THE BASICS: 6 bedrooms & 1 loft - 5 Kings, 2 Bunk beds , and 1 pull-out couch in the loft - Sleeps 16 people. 4 Bathrooms - Master (jetted tub, walk-in shower, double sinks), other 3 bathrooms (tub/shower combo & sink). Fully Equipped Kitchen. Open Main Room with plenty of seating. Dining Room table and bar stools around kitchen island area. Plenty of space to spread out and enjoy your friends/family. Free Wifi. THE EXPERIENCE IN DETAIL: -As you walk in the front door and are greeted by the open floor layout of our kitchen and great room you immediately breathe easy seeing that there is plenty of room here for you and your family. Our Kitchen is stocked with plenty of cookware and dishes so you can create a huge breakfast that will get everyone out of bed and ready for a day of fun. A potted coffee maker and a Keurig is available. You will need to bring your own coffee/pods/filters/creamer etc. Cozy up in the living room for a late night movie on our large flat-screen TV equipped for your viewing pleasure. Our luxury Master bedroom with it’s King size bed, premium bedding, and TV invite you and your spouse to relax together and feel a little spoiled. This is a vacation after all! Enjoy our Master Bath with it’s jetted tub, walk-in shower, and double sinks. Explore the Upstairs which has 4 Bedrooms - 3 furnished with a King size bed, premium bedding, 1 is the bunk room which is equipped with 4 twin size beds. This home is not handicapped accessible!!!"
    },
    "supply_source": "Vrbo",
    "spoken_languages": { ... }
  }
}

Benefit:

Partners selling Vrbo supply require the IPM name in order to build guest messaging to inform them on the name of the IPM who will charge their card and/or send them a confirmation email. Currently, this info is only available as part of the fees.traveler_service content in paragraph form

Marketing Fee in Retrieve - Manage Booking | Feature | V3

Added the estimated value at time of retrieve for room.rate.pricing.totals.marketing_fee to the retrieve response.

Rapid 3 Response Example:

{
  "itinerary_id": "8999989898988",
  "property_id": "8150374",
  ...
  "rooms": [
    {
      "id": "926784314",
      "confirmation_id": { ... },
      ...
      "status": "booked",
      ...
      "rate": {
        "id": "035943984",
        "merchant_of_record": "expedia",
        ...
        "pricing": {
          "nightly": [ ... ],
          "stay": [ ... ],
          "totals": {
            "inclusive": { ... },
            "exclusive": { ... },
            "marketing_fee": {
              "billable_currency": {
                "value": "7.75",
                "currency": "USD"
              }
            },
            "property_fees": { ... }
          },
          "fees": { ... }
        }
      },
      "links": { ... }
    }
  ],
  "billing_contact": { ... },
  ...
}

Benefit:

Partners will be able to see an updated value for the marketing_fee after Hard Changes have been made to the booking.

Travel Purpose in Retrieve - Manage Booking | Feature | V3

Added the stored value of travel_purpose to the retrieve response.

Rapid 3 Response Example:

{
  "itinerary_id": "8999989898988",
  "property_id": "8150374",
  ...
  "conversations": {...}
  "travel_purpose": "leisure",
  "trader_information": {...}
}

Benefit:

Partners will be able to review the value that was communicated to the property on whether the traveler is traveling for business or leisure.

Inactive Properties - Content | Feature | V3

Added the Inactive Properties endpoint.

Rapid 3 Request Example:

https://test.ean.com/v3/properties/inactive?since=2023-07-12

Rapid 3 Response Example:

[
  {
    "property_id": "15316"
  },
  {
    "property_id": "15362666"
  },
  {
    "property_id": "15462554"
  },
  {
    "property_id": "1614382"
  },
  {
    "property_id": "18762476"
  }
]

Benefit:

Partners will be able to quickly and easily remove properties from their cached content, and know which properties to no longer send availability requests for.

Travel Purpose Indicator - Shop | Feature | V3

Added travel_purpose parameter to the availability request.

Rapid 3 Request Example:

New parameter for availability request:

travel_purpose=business

Benefit:

Partners will be able to communicate whether the traveler is traveling for business or leisure.

Unavailable Reason - Shop | Feature | V3

Added the include parameter to the availability request with the value unavailable_reason to request that the response contain entries for properties with actionable reasons that no rates were returned.

Rapid 3 Request Example:

New parameter for availability request:

include=unavailable_reason

Benefit:

Partners will be able to include information about why a property is unavailable as part of shopping results.

Amenity Category search - Shop | Feature | V3

Added amenity_category parameter to the availability request.

Rapid 3 Request Example:

New parameter for availability request:

amenity_category=wifi

Benefit:

Partners will be able to search for rates that include amenities with matching categories.

Inclusive Strikethrough - Shop | Feature | V3

Added pricing information for inclusive_strikethrough.

Rapid 3 Response Example:

[
  {
    "property_id": "19248",
    "rooms": [
      {
        "id": "123abc",
        "room_name": "Fancy Queen Room",
        "rates": [
          {
            "id": "333abc",
            ...
            "occupancy_pricing": {
              "2": {
                "nightly": [ ... ],
                "stay": [ ... ],
                "totals": {
                  "inclusive": { ... },
                  "exclusive": { ... },
                  "inclusive_strikethrough": {
                    "billable_currency": {
                      "value": "726.63",
                      "currency": "CAD"
                    },
                    "request_currency": {
                      "value": "549.60",
                      "currency": "USD"
                    }
                  },
                  "strikethrough": { ... },
                  "marketing_fee": { ... },
                  "gross_profit": { ... },
                  "minimum_selling_price": { ... },
                  "property_fees": { ... }
                },
                "fees": { ... }
              }
            }
          }
        ]
      }
    ]
  }
]

Benefit:

Partners will be able to merchandise the savings due to a hotel funded discount, inclusive of taxes and fees.

Hard Change - Book | Feature | V3

Added the new Hard Change endpoint and flow to Rapid.

Benefit

Partners can now modify bookings on behalf of their travel customers through the Rapid API.

See Hard Change for more details.

Itinerary History - Book | Feature | V3

Added itinerary history information to the Itinerary Search and Itinerary Retrieve calls.

Benefit

Partners can now retrieve the details of itinerary history related to creation, hard changes, and cancellation as part of Itinerary Search or Itinerary Retrieve.

See Itinerary History for more details.

VRBO Host Free Text Description - Content | Feature | V3

Added free_text to vacation_rental_details section of Property Content response.

Rapid 3 Schema Example:

{
  "12345": {
    "property_id": "12345",
    "name": "Test Property Name",
    "phone": "1-417-862-0153",
    "vacation_rental_details": {
      "free_text": "Free form description and explanation of property provided by the host.Can possibly contain html break tags.",
      "listing_id": "1237874"
    }
  }
}

Note: Not all properties of content response represented in example

Benefit

Partners will be able to present more information about a Vacation Rental property that is provided by the Host.

Please refer to the VRBO on Rapid Integration Guide

Regions Search enhancements - Geography | Feature | V3

Added several new search parameters:

• area Define an area using a radius and either a coordinate (latitude / longitude pair) or a region id
• limit Restrict the number of results returned
• country_subdivision_code Return results that match the ISO 3166-2 country subdivision code

Added country_subdivision_code to the Regions and Region responses

Benefit

Partners will be able to select Regions that intersect with specified areas.

Airport search within 50km of a lat/long:

type=airport&limit=3&area=50,37.227924,93.310036

OpenAPI Specification improvements - Update | V3

Multiple different improvements to the OpenAPI Specification:

• Dates are quoted so that they will be represented correctly in API Explorer
• BoundingPolygon tweaked again to improve compatibility with the Java client generated code
• Improved consistency when referencing ISO standards (eg. ISO 639-1 alpha-2 and ISO 3166-1 alpha-2)

This change does not impact API functionality, just improves the OpenAPI Specification.

Benefit

Enhanced functionality in the API Explorer and improved compatibility for Partners using the downloaded OpenAPI Specification yaml file.

Exclude Refundable Damage Deposit Rates - Shop | Feature | V3

Added exclusion parameter to availability requests

Rapid 3 Request Example:

New parameter for Shop request:

exclusion=refundable_damage_deposit

Benefit:

Partners will be able to designate that the response should not include rates with refundable damage deposits.

Clarified Geography Polygons and examples - Geography | Update | V3

The specification had inaccurate details for the formats of Polygons in coordinate requests and responses. The examples have been updated to be usable in API Explorer for the Geography endpoints.

This change does not impact API functionality, just fixes the OpenAPI Specification.

Rapid 3 Schema Example:

This is a trimmed example from a regions response:

"coordinates": {
      "center_longitude": -93.29277,
      "center_latitude": 37.207935,
      "bounding_polygon": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -93.298931,
              37.205162
            ],
            [
              -93.28672,
              37.205299
            ],
            [
              -93.286549,
              37.21005
            ],
            [
              -93.286763,
              37.210221
            ],
            [
              -93.298931,
              37.205162
            ]
          ]
        ]
      }
    },

Benefit:

The specification now accurately reflects that regions can return both Polygon and MultiPolygon objects in the response. It also provides an accurate schema and example for a polygon search.

Vrbo Availability Calendar - Shop | Feature | V3

Added the Vrbo Availability Calendar endpoint, "/calendars/availability".

Rapid 3 Schema Example:

[
    {
        "property_id": "1234",
        "days": [
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            },
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            }
        ]
    }
]

Benefit:

The Rapid Availability Calendar API provides a snapshot of daily availability for a given property over a period of time, which can be used to assist a guest viewing the property details page.

More details can be found here.

Enhanced House Rules - Content | Feature | V3

Enhanced House Rules, a replacement for House Rules, has been added to the Rapid Content API for Vrbo properties.

Rapid 3 Schema Example:

"enhanced_house_rules": {
        "CheckIn": {
            "rule": "Check in after 3:00 PM",
            "additional_information": []
        },
        "CheckOut": {
            "rule": "Check out before 11:00 AM",
            "additional_information": []
        },
        "Occupancy": {
            "rule": "Maximum overnight guests: 5 (sleeps up to 5 adults)",
            "additional_information": []
        },
        "MinBookingAge": {
            "rule": "Minimum age to rent: 18",
            "additional_information": []
        },
        "Children": {
            "rule": "Children allowed: ages 0-17",
            "additional_information": []
        },
        "Pets": {
            "rule": "Pets allowed: 1 pet less than 10kgs",
            "additional_information": [
                "Pets allowed under aproval/Se requiere aprobacion"
            ]
        },
        "Events": {
            "rule": "No Events allowed",
            "additional_information": []
        },
        "Smoking": {
            "rule": "Smoking allowed: outside",
            "additional_information": [
                "Silence is required after 10pm/Silencio 10pm",
                "At the balcony, Thank you! En el balcon, Gracias!"
            ]
        }
    }

Benefit:

Enhanced House Rules enables clearer display of property policies, including free text notes from the host, to describe limits/exceptions to each policy or other information relevant to the guest’s stay.

Geography enhancements - Geography | Feature | V3

The Geography calls now have the following enhancements:

• Added supply_source filtering to Region, Regions, and Properties within Polygon requests.
• Added Pagination-Total-Results header to Region, Regions, and Properties within Polygon responses.
• Added type and country_code filtering to Regions request.

Benefit:

These enhancements to the various Geography calls give partners more fine-tuned control over what results they receive back.

Nonrefundable Date Range added - Shop | Manage Booking Feature | V3

Added the nonrefundable date range object to availability and itinerary responses.

Rapid 3 Schema Example:

"nonrefundable_date_ranges": [
    {
    "start": "2022-09-05",
    "end": "2022-09-11"
    }
   ],

Benefit:

Partners will be able to display refund exceptions set by the supplier based on holidays or other factors, so travelers are better informed of when they will receive a refund on cancellation.

Categories list and Tags list added to the Region responses - Geography | Feature | V3

Added the categories list and tags list to all Region responses.

Rapid 3 Schema Example:

"categories": [
    "tourism:region"
],
"tags": [
    "geoAdmin:city"
]

Benefit:

Partners will be able to make use of the categories and tags to get metadata information about the returned region.

Rapid Version 2.3 and 2.4 Retired - Remove | V2.4 | Breaking Change

The 2.3 and 2.4 versions of the Rapid API have now been retired.

Unit Configurations for Vrbo added to Content - Content | Feature | V3

Added the unit configuration object to Content responses.

Rapid 3 Schema Example:

[
    {
        "property_id": "1234",
        "days": [
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            },
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            }
        ]
    }
]

Benefit:

Unit configurations describes the bed type(s) in a room and how many of each bed type are in the room.

Chinese (Hong Kong) language added - Content | Shopping | Feature | V3

The Chinese (Hong Kong) language option has been added. "zh-HK" language code can now be used in requests where the language parameter is supported.

A list of all supported languages can be found here.

Vrbo Essential Stay Information - Manage Booking | Feature | V3

Added Vrbo essential stay information to the itinerary responses.

Rapid 3 Schema Example:

"essential_information": {
  "contact": {
    "name": "John test",
    "phone": {
      "country_code": "1",
      "area_code": "367",
      "phone_number": "6876876"
    },
    "email": "dv@devmail.wvrgroup.internal",
    "address": {
      "line_1": "3rd St",
      "line_2": "421 W",
      "city": "Austin",
      "state_province_code": "TX",
      "postal_code": "86868",
      "country_code": "US"
    }
  },
  "essentials": [
    {
      "name": "directions",
      "instructions": "30.3079827,-97.8934852\n\nTurn right into the alley at the end of the road.",
      "images": [
        {
          "url": "https://odis-stage.vrbo.com/odis/hospitality/a94d96e2-499b-4155-8872-6d0a4dd9a9db.large.jpg",
          "width": 1024,
          "height": 768
        },
        {
          "url": "https://odis-stage.vrbo.com/odis/hospitality/e1713ff4-ad67-4498-93a1-befbdf5275a0.large.jpg",
          "width": 1024,
          "height": 768
        }
      ]
    },
    {
      "name": "wifi",
      "instructions": "Secure, hi speed wifi is available throughout the property.",
      "images": [
        {
          "url": "https://odis-stage.vrbo.com/odis/hospitality/caa47f61-3e7f-459b-bd74-e3cfe76a0edc.large.jpg",
          "width": 1024,
          "height": 768
        }
      ],
      "additional_info": {
        "network_name": "HomeNetwork",
        "network_password": "HomeNetwork1234567890"
      }
    },
    {
      "name": "thermostat",
      "instructions": "Thermostat\n\nDo not adjust thermostat below 59F/15C."
    }
  ],
  "updates_available_datetime": "2022-08-14T09:00:00-05:00"
}

Benefit:

Vrbo Essential Stay Content provides important pre-arrival instructions to travelers including the property address and the property manager’s contact information. It can also include certain other key details that the traveler might need upon arrival, during their stay, or at departure.

New Deal For Consumers (ND4C) regulatory change for all versions - Shopping | Booking | Manage Booking | Feature | V3 | Breaking Change

Changes made to Rapid to address the impact of "New Deal for Consumers" (ND4C) regulation on your business. This law will impact European Union and United Kingdom points of sale.

Rapid 3 Schema Example:

"trader_information": {
  "traders":[
    {
       "name": "Expedia",
       "address": {
         "line_1": "555 1st St",
         "line_2": "10th Floor",
         "line_3": "Unit 12",
         "city": "Seattle",
         "state_province_code": "WA",
         "postal_code": "98121",
         "country_code": "US"
       },
      "email": "travel@support.expedia.com",
      "phone": "0330-123-1235",
      "contact_message": "This property is managed by a professional host. The provision of housing is linked to trade, business or profession."
     }
   ],
   "terms_and_conditions": "https://www.expedia.com/terms_and_conditions"
}

Benefit:

Gives partners trader information in order to comply with ND4C regulatory requirements.

Croatian and Lithuanian Languages Retired - Content | Shopping | Remove | V3

Croatian and Lithuanian languages have been retired. Attempting to pass these languages into a request that accepts the language parameter will result in an error.

Rapid Version 2.3 and 2.4 Deprecated - Deprecated | V2.4 | Breaking Change

The 2.3 and 2.4 versions of the Rapid API have now been deprecated. Both versions will be retired in October 2022.

Rapid Version 2.2 Retired - Remove | V2.2 | Breaking Change

The 2.2 version of the Rapid API has now been retired.

Added request body to Notifications Test API - Notifications | Change | V3 | Breaking Change

A request body is now required.

Rapid 3 Schema Example:

{
    "event_type": "itinerary.agent.create"
}

Benefit:

Ensuring consistency across the Rapid API.

Added undeliverable parameter to Notifications Undeliverable API - Notifications | Change | V3 | Breaking Change

A new query parameter undeliverable is now required.

Benefit:

Ensuring consistency across the Rapid API.

Moved Refundable Damage Deposit and Card On File Limit fields for consistency with Shop - Manage Booking | Change | V3 | Breaking Change

The Refundable Damage Deposit and Card On File limit fields were moved for consistency with Shop.

Rapid 3 Schema Example:

"card_on_file_limit": {
  "value": "string",
  "currency": "string"
},
"refundable_damage_deposit": {
  "value": "string",
  "currency": "string"
},

Benefit:

This simplifies the schema for the partner.

Notifications API endpoints change - Notifications | Change | V3 | Breaking Change

The endpoints of Notifications Test API and Notifications Undeliverable API have been changed (the trailing /{event_type} and /undeliverable were removed). The endpoint of Notifications Test API is changed from GET to POST.

Benefit:

Ensuring consistency across the Rapid API.

Renamed Deposit Policy to Deposits for consistency with Shop - Manage Booking | Change | V3 | Breaking Change

The Deposit Policy object was renamed to Deposits for consistency with Shop.

Rapid 2.4 Schema Example:

"deposit_policies": [
  {
    "amount": "220.75",
    "due": "2018-12-12T01:01:01.000-08:00"
  }
],

Rapid 3 Schema Example:

"deposits": [
  {
    "amount": "220.75",
    "due": "2018-12-12T01:01:01.000-08:00"
  }
],

Benefit:

This simplifies the schema for the partner.

TripAdvisor Content API endpoint deprecated - Content | Deprecate | V3 | Breaking Change

Expedia Group no longer maintains a relationship with TripAdvisor, so in Rapid 3 the TripAdvisor Content API endpoint will be deprecated.

Benefit:

Partners will not be able to call redundant endpoint.

Added Loyalty ID - Booking | Manage Booking | Feature | V3 | Breaking Change

A new feature to enable partners to provide hotel loyalty Id

• Identifier for a hotel loyalty program associated with this room guest.
• Exists under the rooms object

Rapid 3 Schema Example:

"rooms": [
  {
    "given_name": "John",
    "family_name": "Smith",
    "smoking": false,
    "special_request": "Top floor or away from street please",
    "loyalty_id": "ABC123"
  }
],

Notes The new field will be located in multiple places

• Create booking request
• Itinerary Retrieve
• Itinerary Change

Benefit:

Enable partners to include hotel loyalty id and pass on this information onto the hotel.

*For informational purposes, it does not guarantee hotel will offer extra points, benefits

Adding deposit data to the Rapid availability response - Shopping | Feature | V3

Rapid 3 will remove the need for our partners to make a separate call for deposit (payment schedule) information. Instead we will be surfacing this data as a child of the Rate object.

Along with removing the need to make an additional call for deposit (payment schedule) data, we will be making the data available in the priceCheck response for higher visibility.

Rapid 3 Schema Example:

"deposits": [
  {
    "value": "70.00",
    "due": "2021-08-21",
    "currency": "CAD"
  }
]

Rapid 3 will no longer need to return a deposits link for the retrieval of the deposit data. This will be fetched and displayed in the response instead.

Rapid 2.4 Schema Example:

"links": {
  "payment_options": {
    "method": "GET",
    "href": "/2.4/properties/19248/payment-options?token=MY5S3j36cOcL"
  },
  "deposit_policies": {
    "method": "GET",
    "href": "/2.4/properties/19248/deposit-policies?token=MY5S3j36cOcL"
  }
}

Rapid 3 Schema Example:

"links": {
  "payment_options": {
    "method": "GET",
    "href": "/2.4/properties/19248/payment-options?token=MY5S3j36cOcL"
  }
}

Rapid 3 will no longer return a deposit_required field, as it would be redundant with the new array of deposits.

Rapid 2.4 Schema Example:

"sale_scenario": {
  "package": false,
  "member": true,
  "corporate": false,
  "distribution": false
},
"deposit_required": true,
"merchant_of_record": "expedia",

Rapid 3 Schema Example:

"sale_scenario": {
  "package": false,
  "member": true,
  "corporate": false,
  "distribution": false
},
"merchant_of_record": "expedia",

Benefit:

Partners will no longer need to make an additional call for the data. It will be embedded within the response.

Adding support for vacation rental card_on_file_limit and refundable_damage_deposit in the priceCheck response - Shopping | Feature | V3

Added additional data relevant to vacation rentals. The card_on_file_limit is the maximum that can be charged to a card for damages at the property and the refundable_damage_deposit is the deposit amount required for the property. Only one value will be available in the response, we will never be returning both simultaneously to a partner for a given rate.

Rapid 3 Schema Example:

"card_on_file_limit": {
  "value": "25.00",
  "currency": "CAD"
},
"refundable_damage_deposit": {
  "value": "75.00",
  "currency": "CAD"
}

Benefit:

Partners will have full visibility of the deposits and expectations for vacation rental properties.

Mandatory supply_source field added to Property Content API/File and Property Catalog File - Content | Feature | V3 | Breaking Change

A new mandatory supply_source field has been added to the Property Content API/File and the Property Catalog File, to enable partners to specify which type of inventory they want returned.

Passing a value of 'expedia' will return only inventory from Expedia.

Passing a value of 'vrbo' will return only inventory from Vrbo.

Rapid 3 Schema Example:

"supply_source": "vrbo"

Notes supply_source is now a mandatory field. To achieve the same behaviour as previous versions of the API, partners will need to pass "supply_source": "expedia".

Benefit:

Partners will be able to access Vrbo inventory via the same endpoint as Expedia inventory

New section added to the Property Content API/File consolidates Vacation Rental specific property and room information - Content | Feature | V3 | Breaking Change

Added new Vacation Rentals section to Rapid Content/File where partners can find property information which is specific to Vacation Rentals, including attributes which would normally be found within the room description for multi-unit properties.

Display of the rental agreement on the partner's checkout page is now a Rapid launch requirement for Vacation Rental properties.

Rapid 3 Schema Example:

"vacation_rental_details": {
  "property_registration":{
  },
  "private_host"{
  },
  "property_manager": {
    "name": "Frans Belderbos",
    "links": {
      "image": {
        "method": "GET",
        "href": "https://odis.vrbo.com/odis/story/89cd116a-14fd-4fbc-a0d1-861894171cd0.c1.jpg"
      }
    },
    "rental_agreement": {
      "links": {
        "rental_agreement": {
          "method": "GET",
          "href": "https://www.vrbo.com/td/proxies/ecomQuote/downloadRentalAgreement?unitUrl=/units/0000/1341f175-3550-4c80-b9a1-b6b330b7e032"
        }
      }
    },
    "house_rules": [
        "Children welcome",
        "Pets welcome (restrictions apply)",
        "No smoking",
        "No parties or events"
      ],
    "amenities": {
        "1073743284": {
            "id": "1073743284",
            "name": "Heating"
        },
        "4296": {
            "id": "4296",
            "name": "Furnished balcony or patio"
        }
    }
  }
}

Benefit:

Provides more property details which enable improved property display for single unit vacation rentals, all in a vacation rental specific section of our content response.

Third Party Authentication for PSD2 - Booking | Feature | V3 | Breaking Change

A new product to enable partner to use their preferred payment services provider for PSD2 compliance

Requires the cavv, eci, three_ds_version and ds_transaction_id parameters

Rapid 3 Schema Example:

"third_party_authentication": {
  "cavv": "jELUbgG+Tgj0AREBDMLeCad+oIs=",
  "eci": "05",
  "three_ds_version": "2.2.0",
  "ds_transaction_id": "ac01cc2b-c1a1-4981-8c6f-400d4eec88de",
  "pa_res_status": "Y",
  "ve_res_status": "C",
  "xid": "47133847-13be-4ae3-9be9-e4053b9c83c0",
  "cavv_algorithm": "3",
  "ucaf_indicator": "0"
}

Benefit:

Enable partners to use their preferred payment services provider for PSD2 compliance

Added special character encoding to fix security bug - Booking | Bug Fix | V3 | Breaking Change

Special characters in several fields will be re-encoded to prevent a security vulnerability.

Benefit:

This removes a potential security vulnerability.

Fixed Price Check test header bug - Shopping | Bug Fix | V3

An invalid test header for the Price Check call was renamed to match a valid value.

Rapid 2.4 Schema Example:

--header "Test: matched"

Rapid 3 Schema Example:

--header "Test: available"

Benefit:

Allows the partner to test their integration with Price Check more thoroughly.

Fixed typo in Customer_account_Details enum - Booking | Bug Fix | V3 | Breaking Change

Fixed typo in customer_account_details enum, changing "fido_authenticaton" to "fido_authentication".

Rapid 2.4 Schema Example:

"customer_account_details": {
  "authentication_method": "fido_authenticaton",
  "authentication_timestamp": "2018-02-12T11:59:00.000Z",
  "create_date": "2018-09-15",
  "change_date": "2018-09-17",
  "password_change_date": "2018-09-17",
  "add_card_attempts": 1,
  "account_purchases": 1
},

Rapid 3 Schema Example:

"customer_account_details": {
  "authentication_method": "fido_authentication",
  "authentication_timestamp": "2018-02-12T11:59:00.000Z",
  "create_date": "2018-09-15",
  "change_date": "2018-09-17",
  "password_change_date": "2018-09-17",
  "add_card_attempts": 1,
  "account_purchases": 1
},

Benefit:

This eliminates a spelling mistake which may confuse partners.

Cross Sell and Alternative Property Recommendations removed - Recommendations | Remove | V3 | Breaking Change

reference_property_id, destination_iata_airport_code, origin_iata_airport_code, and iata_airline_code parameters have been removed. Recommendations link will no longer appear on the response.

Rapid 2.4 Schema Example:

"recommendations": {
  "method": "GET",
  "href": "/2.4/properties/availability?token=abcdef"
}

Benefit:

Partners will not be able to call using redundant request parameters

Removed deprecated fields in Fees object - Shopping | Booking | Manage Booking | Remove | V3 | Breaking Change

The Fees object was simplified by removing fields that were informational and caused confusion in displaying fee totals.

Rapid 2.4 Schema Example:

"fees": {
  "mandatory_fee": {
    "billable_currency": {
      "value": "5.00",
      "currency": "CAD"
    },
    "request_currency": {
      "value": "3.00",
      "currency": "USD"
    },
    "scope": "per_person",
    "frequency": "per_day"
  }
}

Rapid 3 Schema Example:

"fees": {
  "mandatory_fee": {
    "billable_currency": {
      "value": "5.00",
      "currency": "CAD"
    },
    "request_currency": {
      "value": "3.00",
      "currency": "USD"
    }
  }
}

Benefit:

Scope and frequency have been removed to help clarify the fees charged. This removes unnecessary fields and simplifies the schema for the partner.

Removed /properties/{property_id}/deposit-policies path - Shopping | Remove | V3

The deposit-policies endpoint will be removed since it's now part of the availability call directly.

Benefit:

Partners won't have to make an additional call to get deposit policy information.

Clarified Postal Code description - Booking | Update | V3

The Postal Code field's description was simplified to be less confusing.

Rapid 2.4 Schema Example:

Customer's postal code. Postal_Code is mandatory if the payment type is a credit card (CC, CCC, VCC) and the country code is US, GB or CA.

Rapid 3 Schema Example:

Postal/zip code.

Benefit:

Clarifies when the field is required.

Clarified Rate Plan Count description - Shopping | Update | V3

Clarified Rate Plan Count description The Rate Plan Count field's description was updated to include minimum and maximum limits as well as clarifying what the field is trying to return (the best price available).

Rapid 2.4 Schema Example:

The number of rates to return per property. The rate’s price determines which rates are returned e.g. a rateplancount=4 will return the lowest 4 rates, but the rates are not ordered from lowest to highest or vice versa in the response. The lowest rate has been proven to provide the best conversion rate and so a value of 1 is recommended. The value must be greater than 0.

Rapid 3 Schema Example:

The number of rates to return per property. The rates with the best value will be returned, e.g. a rate_plan_count=4 will return the best 4 rates, but the rates are not ordered from lowest to highest or vice versa in the response. Generally lowest rates will be prioritized. The value must be between 1 and 250.

Benefit:

Clarifies valid values for the field.

Clarified State Province Code description - Booking | Update | V3

The State Province Code field's description was simplified to be less confusing.

Rapid 2.4 Schema Example:

Customer’s state or province code. Mandatory if the country_code = US, AU or CA

Rapid 3 Schema Example:

2-letter or 3-letter state/province code for Australia, Canada and the USA.

Benefit:

Clarifies when the field is required.