Skip to content

Troubleshooting Availability error responses

HTTP error codes are standardized as follows:

If the endpoint encountersThe endpoint returns
Authentication failedHTTP 401
Schema validations such as invalid integer, date.HTTP 400
All updates with errors.HTTP 400
At least one successful update.HTTP 200 in addition to errors or warnings, if any.
All updates are unauthorized.HTTP 403
INTERNAL_SERVER_ERROR.HTTP 500

Warnings on v1.1

New error codeError messageNotes
WARN_UNPROCESSED_ADDITIONAL_GUESTAdditional guest updates weren't processed. Please try again later.
WARN_DUPLICATE_DATESRequest contains duplicate dates, we have applied only the first occurrence.When the same date appears multiple times in one request, only the first occurrence is processed. Remove duplicate dates to avoid unexpected results.
NUMBER_OF_NIGHTS_EXCEEDS_MAX_FOR_LINESThe update has too many nights and only the first 90 nights were considered.Applies to the los_pricing endpoint. Each date can contain a maximum of 90 night prices (one per night of the stay). Only the first 90 are processed.

Error codes on v1.1

Error codeError messageNotes
ROOM_ID_MISSINGRoom ID is missingRoom ID is required for the request.
ROOM_ELEMENT_REQUIREDRoom is missingThe request contains an empty request body.
FROM_DATE_SHOULD_BE_LESS_THAN_TO_DATEFrom date should be less than or equal To DateThe From date should be less than or equal to the To date.
LOS_PRICING_PASSED_FOR_OBP_RATELOS pricing format sent for OBP room-rateThe request contains pricing information in LOS pricing format. However, the property is set to OBP pricing type.
LOS_PRICING_PASSED_FOR_DEFAULT_RATELOS pricing format sent for Standard room-rateThe request contains pricing information in LOS pricing format. However, the property is set to Standard pricing type.
OBP_PRICING_PASSED_FOR_DEFAULT_RATEOBP format sent for Standard room-rateThe request contains pricing information in OBP pricing format. However, the property is set to Standard pricing type.
CANT_SET_PERCENTAGE_FOR_OBP_LOSCannot set percentage for OBP/LOS room-rateThe request is trying to send percentage pricing for Flexible Children Rates (FCR) while the roomrate is on OBP or LOS pricing mode. This is not accepted. You can set a fixed amount FCR in case the roomrate is on OBP or LOS pricing model.
ADDITIONAL_PRICE_TYPE_CAN_BE_CHILDREN_ONLYAdditional guest type can only be childFor the Type attribute of <additional_guest> element, the only supported value is child.
INVALID_CURRENCY_CODESupplied currency code '%s' doesn't match the hotel's currency code '%s' for room ID '%s' and rate ID '%s'Currency code in the request should match the property's currency code.
INVALID_USE_OF_SINGLE_OCCUPANCYCannot set price for occupancy 1. Please check the room-rate pricing modelCannot set pricing for single occupancy as the pricing type of the property or roomrate is other than Standard.
RATE_EDITABLE_ONLY_ON_EXTRANETRate '%s' is only editable on ExtranetYou are not allowed to edit the rate via the connectivity API. The property can edit the rate via the Booking.com extranet.
ROOM_EDITABLE_ONLY_ON_EXTRANETRoom '%s' is only editable on ExtranetYou are not allowed to edit the room via the connectivity API. The property can edit the room via Booking.com extranet.
RATE_NOT_ACTIVE_FOR_ROOMRate '%s' is not active for room '%s'Rate is not activated for the selected room. Please check allowed roomrates using the roomrates endpoint.
HOTEL_ACCESS_DENIEDRequest for forbidden hotel id(s)Check the property ID and either provide the correct property ID or make sure the machine account credentials have enough permissions.
HOTEL_ID_INVALIDHotel ID '%s' is not validThe hotel ID in the request does not exist or is not accessible. Verify the hotel ID and your machine account permissions.
ROOM_DOES_NOT_EXISTRoom ID '%s' does not belong to the propertyThe room ID does not belong to the specified property. Retrieve valid room IDs using the rooms endpoint.
NOT_A_VALID_OCCUPANCYAn occupancy may not be zero, Occupancy '%s' may not be negative, Occupancy '%s' exceeds maximum value $MAX, Occupancy '%s' does not look numericMake sure to send pricing information for the correct occupancy level defined in the roomrate for the specific roomtype.
NOT_A_VALID_DATEDates should be in YYYY-MM-DD format, not before '%s', and not be past '%s'The supplied date format is invalid or the date is outside the allowed range. Use the yyyy-mm-dd format.
INVALID_DATEDate format is invalid. Accepted format is yyyy-mm-ddThe date value does not follow the required format. Use yyyy-mm-dd.
PRICE_EXCEEDS_MAX_PRICEYou are setting ‘$price’ for room ID ‘%room_id’, rate ID ‘%rate_id’ and date ‘%date’ which exceeds the maximum allowed price of ‘%max_price’You are setting the price for the combination of room, rate and date that exceeds the maximum price set.
PRICE_BELOW_MIN_PRICEYou are setting ‘$price’ for room ID ‘%room_id’, rate ID ‘%rate_id’ and date ‘%date’ which is below the minimum allowed price of ‘%min_price’You are setting the price for the combination of room, rate and date that goes below the minimum price set.
NOT_A_VALID_RELEASE_TIMERelease times should be in the expected format. This is not the case for room ID $room_id, rate ID $rate_id on date '$date'Make sure to specify the release time in the expected format.
TYPE_VIOLATIONGeneric error when provided data type is different than specified.
HOTEL_HAS_MISCONFIGURED_UFIThe timezone value is missing for the Ufi associated with hotel ID $hotel_idCheck the property's UFI configuration.
INVALID_GUEST_AGE_BANDPlease define a to and from ages that match an age bucketSee flexible children rates.
INVALID_GUEST_AGE_BAND_IDPlease define an existing age bucket IDThe age bucket ID does not exist in the property's children policy, or is outside the valid range (1, 2, 3, or 4). See managing flexible children rates.
INVALID_ADDITIONAL_PRICESPrices length cannot be 0See flexible children rates.
ADDITIONAL_GUEST_PRICE_DATES_OVERLAPThe dates of the guest prices cannot overlap for the same roomId and rateIdSee flexible children rates.
PROVIDED_DATES_OUTSIDE_ALLOWED_RANGEPlease check if date is not in the past or more than 4 years in the futureSee flexible children rates.
INVALID_ADDITIONAL_GUEST_NUMBERInvalid additionalGuestNumber. It should be a non negative number up to 10See flexible children rates.
PRICE_LESS_THAN_0There's no support for negative pricesPrice must be greater than 0. See flexible children rates.
PRICE_GREATER_THAN_10_DIGITSMax Price Value is 9999999999.9999See flexible children rates.
PRICE_PERCENTAGE_IS_BIGGER_THAN_100Percentage should be between [0.0, 100.0]See flexible children rates.
PRICE_PERCENTAGE_IS_ZEROThere's no support for percentage price zeroSee flexible children rates.
ADULT_PERCENTAGE_IS_MIXEDPrice Type Adult Percentage cannot be mixed with other price types for the same Age Band IdDon't mix AdultPercent with Percent or fixed amounts for the same age band. See flexible children rates.
PRICE_DATES_OVERLAPThe dates of the prices cannot overlap for the same guestNumber and ageBucket. The dates [Date{year=%s, month=%s, day=%s},Date{year=%s, month=%s, day=%s}] overlaps with [Date{year=%s, month=%s, day=%s},Date{year=%s, month=%s, day=%s}] for guestNumber: %s and ageBucket: %s
DATE_ELEMENT_MISSINGDate is missingDate is required for this request.
RATE_ID_REQUIREDRate Id is requiredRate id is required for this request.
RATE_LEVEL_INVENTORYRate ID is required, you need to set inventory for each room-rate since room '%s' is on rate level inventory settingThe room is configured with rate-level inventory. Specify a rate_id for each inventory update.
OBP_PRICING_PASSED_FOR_RLO_RATEOBP format sent for RLO room-rateRoom-rate is on RLO pricing model while request is trying to set OBP prices for it.
ROOM_ID_INVALIDRoom ID '%s' is not validProvide a valid Room ID. Make sure to retrieve the correct Room ID using the rooms endpoint.
RATE_IS_A_SLAVE_RATEYou cannot set $attribute for a child rate $rate_id, since they are automatically set based on Rate RelationsCannot update a child rate.
CURRENCY_SWITCH_IN_PROGRESSThere is a hotel currency switch currently in progressYou need to wait until hotel switch currency.
EXCEEDS_MAX_RELATIVE_RELEASE_TIMERelative release time {release_time} exceeds max allowed value. This is not the case for room id{room_id}, rate id {rate_id} on date{date}You are setting release time that exceeds the maximum allowed value.
OCCUPANCY_EXCEEDS_MAX_PERSONSRoom '%s' has a maximum occupancy of '%s'. You cannot set price for higher occupancy for rate '%s'Cannot set pricing for occupancy that is higher than the maximum occupancy.
NOT_A_VALID_RESTRICTIONYou are trying to set the value '%s' for restriction min_stay_arrival for room id '%s', rate id '%s', and date '%s'. It must be 0 or exceed 31.The value for min_stay_arrival or min_stay_through is invalid. Certain special products in specific regions require the restriction value to be either 0 (no restriction) or greater than 31 days. Verify the restriction requirements for your property type and region, then update the value accordingly.
NOT_A_VALID_PRICEValues of prices should be within the acceptable range. This is not the case for room id %s, rate id %s on date '%s'.Price cannot be set lower or higher than the defined Booking.com acceptable values.
NOT_VALID_OCCUPANCY_PRICEValues of OBP prices should be a mapping of occupancy to prices. A valid occupancy price must be greater than 0 and less than %s. This is not the case for room id %s, rate id %s on date '%s'.Price cannot be set lower or higher than the defined Booking.com acceptable values.
AUTHENTICATION_FAILUREAuthentication failed for the requestThe credentials provided in the request was not sufficient for a successful authentication check. To fix a failed authentication request, see the Authentication page.
INTERNAL_SERVER_ERRORInternal server errorBooking.com service failed.