Rate threshold resourcesCopy link

Rate thresholds define the minimum and maximum acceptable amounts that can be pushed for a room night, under any rate plan of the room type. They are used to verify that the rate being pushed for the rate plans of this room are not abnormally low or abnormally high. You can only read rate thresholds; they cannot be set, changed, or deleted.

Room type rate thresholds can be defined by Expedia Group in one of two ways: set by a manual override, or automatically calculated from the last 10 bookings made against any rate plan of the room type. By default, the automatic method is used. Thresholds will not be returned until at least 10 reservations were made, so it is expected that newer room types will have no room type thresholds defined. When no room-specific thresholds exist, Expedia Group defaults to global thresholds not exposed via this API.

The Product API response is transmitted through a synchronous connection to update the property’s system with the status of the Product API request. If a connectivity problem or another issue occurs, an error code will be returned that indicates what issue occurred.

Product API is RESTful and all requests and responses must be sent over a secure connection. All request and response bodies, including errors are encoded in JSON.

To facilitate integrating with Product API, Expedia Group offers a

Obtain rate thresholds for a single room type

• Method: GET
• URL: https://services.expediapartnercentral.com/properties/{propertyId}/roomTypes/{roomTypeId}/rateThresholds
• Consumes: HTTP Request (GET)
• Produces: application/vnd.expedia.eps.product-v3+json

Request parameters

Success responses

Definitions

RateThresholds resource definition

RateThresholdsLinks resource definition

Example

The room type's rate thresholds resource defines the configuration of the rate thresholds applicable to all rate plans of a room type. It defines the lowest and highest acceptable rates for any rate plans of a room, for a stay date.

This example shows how to retrieve the rate thresholds for a given room type.

Request:

1GET https://services.expediapartnercentral.com/properties/1780044/roomTypes/200828484/rateThresholds
2Content-Type: application/vnd.expedia.eps.product-v2+json
3Accept: application/vnd.expedia.eps.product-v2+json
4Request-ID : 307af24f-f59a-11e4-822e-005056b1298f
5Authorization: Basic [your encoded username:password in Base64]

Response:

If there are rate thresholds defined for the room type, the response would be as follows:

1{
2  "entity": {
3    "type": "SellLAR",
4    "minAmount": 98.55,
5    "maxAmount": 310.2,
6    "source": "RecentBookings",
7    "_links": {
8      "self": {
9        "href": "https://services.expediapartnercentral.com/properties/1780044/roomTypes/200828484/rateThresholds"
10      }
11    }
12  }
13}

If there are no rate thresholds defined for the room type, the response will be empty:

1{}