API error glossary

Please find below a glossary of all possible API Error you may encounter while using Booking.com connectivity solutions. Here you will also find the proposed action to resolve each error type. You can find a summary of your top API Error in the 'Reports' section of the Connectivity Portal.

Error Code API Error Message Error Resolution
ADDITIONAL_DATE_INVALID Promotions Make sure additional_date only contains dates different from stay_date.
ADDITIONAL_EXCEEDS_MAX_LENGTH Derived Prices Additional exceeds maximum length
ADDITIONAL_SHOULD_BE_A_NUMBER Derived Prices Additional should be a number
ATTRIBUTE_VALUE_DOES_NOT_MATCH_TYPE HotelResModifyNotif (OTA)
AVAILABILITY_UPDATE_DISABLE_HOTEL_SWITCHING_CURRENCY Availability,LOS Pricing Updating availability is temporarily disable for the hotel. Currency switch is in progress. Try again later.
AVAILSTATUSMESSAGES_ELEMENT_MISSING HotelAvailNotif (OTA) AvailStatusMessages element is missing Please re-check and add all the required input parameters.
BOOK_DATE_IN_THE_PAST Promotions
BOOK_DATE_START_BEFORE_BOOK_DATE_END Promotions,Promotions
BOOK_END_DATE_IN_PAST Promotions Make sure the promotions end date lies in the future.
BOOK_START_DATE_AFTER_END_DATE Promotions Make sure the promotions end date comes after the start date.
BOOK_START_DATE_IN_PAST Promotions Make sure the promotions start date lies in the future.
CANNOT_EDIT_CHILD_RATE LOS Pricing,LOS Pricing Editing child rate directly is not allowed. Try editing the parent rate Updating Child Rate directly is not allowed. Please update its Parent Rate Category instead
CANNOT_REMOVE_BB_PROMO Promotions
CANNOT_SET_BOTH_ADDITIONAL_AND_PERCENTAGE Derived Prices Both additional and percentage cannot be set
CANNOT_SET_SINGLE_USE_RATE HotelRateAmountNotif (OTA),Availability,HotelAvailNotif (OTA),Availability
CANNOT_USE_BOTH_TAGS_TOGETHER Availability Cannot use both the tags together.
CANT_CANCEL_GUEST_PAID Reporting
CANT_CANCEL_RESERVATION Reporting Validation error
CANT_CHANGE_STAY Reporting
CANT_MARK_CC_AS_INVALID Reporting Please wait at least for a minute after receiving a reservation before reporting an invalid card and try again.
CANT_MARK_RESERVATION_NO_SHOW Reporting
CC_ALREADY_MARKED Reporting No further action required. The guest will receive an email asking to update the Credit Card details.
CC_NOT_REQUIRED Reporting Please include this as a validation at Provider/PMS end. If you want to accept CC, property needs to change the settings at https://admin.booking.com/hotel/hoteladmin/extranet_ng/manage/policies.html?lang=en&hotel_id=HOTEL_ID
CHANGE_PROMOTION_TYPE_NOT_ALLOWED Promotions Please change either the Promotion Type or the input parameters
CHECKIN_DATE_INVALID Reporting
CHECKIN_DATE_INVALID_FORMAT LOS Pricing Checkin date has invalid format
CHECKIN_DATE_IN_PAST LOS Pricing Checkin date is in the past The Check-in Date cannot be lesser than the current date, please adjust it accordingly
CHECKIN_DATE_TOO_FAR_IN_FUTURE LOS Pricing Check in date is more than the allowed number of days in the future Check in date should be no more than 730 days in advance, please adjust it accordingly
CHECKOUT_DATE_INVALID Reporting Checkout date is either lesser than the check-in date (or) the check-in date was changed in the last 24 hours. Please adjust it accordingly
COLUMN_COUNT_SHOULD_BE_MORE_THAN_FOUR LOS Pricing Column count should be more than 4
CONTACT_INFO_MISSING HotelDescriptiveContentNotif (OTA)
CURRENCY_CODE_DONT_MATCH_HOTEL_CURRENCY LOS Pricing The supplied currency code is different than hotel currency
DATES_TOO_FAR_OR_INVALID Availability
DATE_ELEMENT_ATTRIBUTE_NOT_SET Availability Neither from/to not value attribute has been set. Please include the date range for which the availability needs to be set
DATE_ELEMENT_MISSING Availability Date element is missing. Input Start/End date, Lenght of stay, and make sure that the format is right.
DEAL_NAME_EMPTY Promotions Please provide a name for the Deal when creating it
DEAL_NAME_LENGTH_LIMIT_EXCEEDED Promotions Please enter a name that is within the character limit for the field.
DIRECT_PAYMENT Reporting
DISCOUNT_EXCEEDS_MAX_RATE Promotions,Promotions
DISCOUNT_VALUE_MISSING Promotions Please enter a value for the discount amount.
DUPLICATE_RATE_NAME HotelRatePlanNotif (OTA)
DUPLICATE_ROOM_RATE_COMBINATION LOS Pricing Room rate combination occurs twice
END_DATE_BEFORE_START_DATE Room Rates
ERROR_CANNOT_CREATE_BB_PROMO Promotions
EXCLUDED_DATE_INVALID Promotions Please enter a valid input for the excluded date from the Deal.
FILE_CONTAINS_INVALID_RECORDS LOS Pricing File contains invalid records Please check the structure of the request, and input the right parameters for the request.
FILE_CONTAINS_NO_RECORDS LOS Pricing File does not contain any record Please input the necessary fields to complete the task
FORBIDDEN Opportunities,Guest Reviews
FROM_DATE_SHOULD_BE_LESS_THAN_TO_DATE Availability From date should be less than to date. Please enter a valid date, and make sure that the starting date is before the end date.
FROM_OR_TO_DATE_INVALID Availability From or to date is invalid. Please check data format, and replace it with the right one (yyyy-mm-dd)
HOTELBUILDER_ERRORS HotelInvNotif (OTA)
HOTEL_ACCESS_DENIED Room Rates Access denied for hotel Please make sure that the HotelID is correct. If it is correct, check if the property is still connected to you. TIP: requesting no specific hotels will give you reservations to all connected hotels
HOTEL_CODE_EXCEEDS_MAX HotelAvailNotif (OTA) HotelCode is higher than the maximum allowed value
HOTEL_DOESNT_HAVE_PRODUCTS Promotions
HOTEL_ID_INVALID Room Rate Availability,Rooms Hotel id invalid Hotel ID is constituted by numbers. Please do not input the propertys name or other details in this field
HOTEL_ID_MISSING Room Rate Availability Hotel id missing Please insert the hotel ID.
HOTEL_INELIGIBLE_FOR_BB Promotions
HOTEL_INELIGIBLE_FOR_GEO_RATES Promotions
HOTEL_INELIGIBLE_FOR_MOBILE_RATES Promotions
HOTEL_NOT_ALLOWED Rooms,Rates Hotel is not allowed Pleaes add hotel ID to the account
HOTEL_NOT_ALLOWED_FOR_CONNECTION_TYPE Room Rate Availability,Availability,LOS Pricing,Derived Prices Hotel not allowed for connection type. Please check connection type and send right request
HOTEL_NOT_FOUND_FOR_ROOM LOS Pricing Unable to find hotel for room
INTERNAL_ERROR Rooms,Rates Internal error
INTERNAL_SERVER_ERROR Opportunities,Photos,Cancel (OTA),HotelResModifyNotifSplit (OTA),Reporting
INVALID_ACTION Reporting
INVALID_ARGUMENT Photos,Photos,Photos,Guest Reviews,Guest Reviews,Photos
INVALID_BOOK_DATE Promotions
INVALID_BOOK_DATE_END Promotions
INVALID_BOOK_DATE_START Promotions
INVALID_BOOK_TIME_START Promotions
INVALID_CURRENCY_CODE HotelRateAmountNotif (OTA),LOS Pricing please check specs for correct currency code
INVALID_DATE HotelRateAmountNotif (OTA),Availability please use YYYY-MM-DD
INVALID_DISCOUNT Promotions,Promotions
INVALID_EARLY_BOOKER_AMOUNT Promotions
INVALID_HOTELS HotelRateAmountNotif (OTA) please check hotel ID
INVALID_LAST_MINUTE_AMOUNT Promotions,Promotions
INVALID_LAST_MINUTE_UNIT Promotions
INVALID_MAXGUESTAPPLICABLE HotelRateAmountNotif (OTA) when loading rates for preopty on rate level occupancy number of tuests does not neeed to be specified
INVALID_MIN_STAY_THROUGH Promotions
INVALID_NO_CC_PROMOTION_VALUE Promotions
INVALID_PRICE_FOR_CHILD_RATE HotelRateAmountNotif (OTA),Availability,Availability
INVALID_PRICING_MODE HotelRateAmountNotif (OTA)
INVALID_PROMO_NAME Promotions,Promotions
INVALID_PROMO_TYPE Promotions,Promotions
INVALID_ROOM_ID Promotions
INVALID_STAY_DATE Promotions
INVALID_STAY_DATES Promotions
INVALID_STAY_DATE_END Promotions
INVALID_STAY_DATE_START Promotions
INVALID_TARGET_CHANNEL Promotions,Promotions
INV_TYPE_CODE_AND_HOTEL_CODE_MISSING HotelAvailNotif (OTA) Both InvTypeCode and HotelCode are missing. At least one should be present. please include invetnroy code and rate code
LAST_DATE_INVALID Room Rate Availability
LAST_MINUTE_EXCEEDS_MAX_VALUE Promotions,Promotions
LEADING_OCCUPANCY_SHOULD_BE_POSITIVE_NUMBER Derived Prices Leading occupancy should be a positive number please add positive number for leading occupancy
LEAST_STAY_IS_1_NIGHT Reporting
LENGTH_OF_STAY_SHOULD_NOT_BE_ARRAY HotelAvailNotif (OTA) Length of stay should not be an array.
LINE_CONTAINS_INVALID_PRICE LOS Pricing Line contains invalid price values please add correct price
LINE_CONTAINS_NO_PRICE LOS Pricing Line contains no price
LOS_PRICING_PASSED_FOR_RLO_RATE Derived Prices
MAX_OCCUPANCY_INVALID HotelProductNotif (OTA)
MIN_GUEST_APPLICABLE_EXCEEDS_MAX_GUEST_APPLICABLE HotelAvailNotif (OTA) MinGuestApplicable value should be less than or equal to MaxGuestApplicable value.
MIN_STAY_THROUGHT_LIMIT_EXCEEDED Promotions please add correct minimum stay value
MIN_STAY_THROUGH_EXCEEDS_MAX_VALUE Promotions
MISSING_ARGUMENT Guest Reviews
MISSING_BOOK_DATE_START Promotions
MISSING_BOOK_TIME Promotions
MISSING_BOOK_TIME_UNIT Promotions
MISSING_DISCOUNT Promotions
MISSING_ELEMENT HotelRateAmountNotif (OTA),HotelResNotif (OTA)
MISSING_MIN_MAX_LOS HotelRateAmountNotif (OTA) Missing MinLOS or MaxLOS attribute
MISSING_MIN_STAY_THROUGH Promotions
MISSING_POS_AND_DISCOUNT Promotions
MISSING_PROMO_TYPE Promotions
MISSING_RATEAMOUNTMESSAGES_ELEMENT HotelRateAmountNotif (OTA) please add RATE_AMOUNT_MESSAGES
MISSING_ROOM_OBJECTS Availability Room object(s) missing.
MISSING_ROOM_TAG Availability Room tag is missing. please add the room tag
MISSING_STAY_DATE_END Promotions
MISSING_STAY_DATE_START Promotions,Promotions
MISSING_STAY_END_DATE Promotions
MORE_THAN_ONE_BASEBYGUESTAMT_TAG HotelRateAmountNotif (OTA)
MULTIPLE_CURRENCY_CODES LOS Pricing
MULTIPLE_RATE_FOR_ROOM_NIGHT Availability From date should be less than to date. please add only one rate ID for one night
NON_LOS_PRICING_TYPE LOS Pricing,LOS Pricing Pricing type is not LOS Use LOS product call if supported in API. Booking need to fix, so LOS providers have LOS pricing always.
NOT_ALLOWED_FOR_SELECTED_CHANNEL Promotions,Promotions,Promotions,Promotions
NOT_ALLOWED_LOWER_PRICE_FOR_NON_REFUNDABLE Reporting
NOT_ALLOWED_MODIFICATION_BEFORE_CHECKIN Reporting
NOT_ALLOWED_TO_CHANGE_PROMO_TYPE Promotions
NO_DATES HotelAvailNotif (OTA) No dates selected. Please check date range
NO_HOTEL_FOUND_FOR_ROOMS Availability No hotel found for provided room ids. Please check room ID
NO_SHOW_EARLY Reporting Please cancel it tomorrow.
NO_SHOW_LATE Reporting You should have cancelled ealier. Advice property to contact CS
NUMBEROFGUEST_NOT_EQUAL_TO_MINGUESTAPPLICABLE HotelRateAmountNotif (OTA)
NUMBER_OF_DAYS_SHOULD_BE_INTEGER Room Rate Availability Number of days should be an integer. Should be just a number without any special characters
NUMBER_OF_DAYS_SHOULD_BE_LESS_THAN_31 Room Rate Availability Number of days should be less than 31. Please note that that minimum valie is 0 and maximum value is 31
NUMBER_OF_GUESTS_NOT_EQUAL_TO_MAX_GUESTS HotelRateAmountNotif (OTA)
NUMBER_OF_NIGHTS_EXCEEDS_MAX_FOR_LINES LOS Pricing Number of nights in the line is more than the limit defined
OBP_PRICING_PASSED_FOR_DEFAULT_RATE Availability
OCCUPANCY_EXCEEDS_MAX_OCCUPANCY Derived Prices Occupancy exceeds maximum occupancy Please check mapping and use correct occupancy.
OCCUPANCY_NOT_VALID LOS Pricing,HotelRateAmountNotif (OTA),Availability Occupancy is not valid Please note that LOS table can have occupancy up to 36. Also please note that our front end only allow to search for up to 30 adults
OPEN_FAILED_AVAILABILITY HotelSummaryNotif (OTA)
OVER_BOOKED Reporting
PAST_DATE HotelAvailNotif (OTA) Date is in the past. Please use furute days
PERCENTAGE_SHOULD_BE_A_NUMBER Derived Prices Percentage should be a number Please put number
PERSONS_SHOULD_BE_A_POSITIVE_NUMBER Derived Prices Persons should be a positive number Should be just a number without any special characters
PERSON_ATTRIBUTE_REQUIRED_FOR_OCCUPANCY_TAG Derived Prices Person attribute is a required attribute for occupancy tag Check occupancy persons
PRICE_EXCEEDS_MAX_SYSTEM_RATE HotelRateAmountNotif (OTA),LOS Pricing,HotelRateAmountNotif (OTA) Fix the price and make it lower
PRICE_INVALID Reporting Correct price format (remove -)
PRICE_TOO_LOW LOS Pricing,Reporting,HotelRateAmountNotif (OTA),Availability
PROMOTION_ID_INVALID Promotions use correct promotion ID
PROMOTION_ID_MISSING Promotions
PROMO_NAME_EXCEEDS_MAX_LENGTH Promotions,Promotions
RATES_NOT_SELECTED_TO_CREATE_DEAL Promotions
RATE_DESCRIPTION_NEGATIVE HotelRateAmountNotif (OTA)
RATE_DOES_NOT_BELONG_TO_HOTEL HotelAvailNotif (OTA)
RATE_DOES_NOT_EXIST Availability,HotelAvailNotif (OTA) Rate does not exist. use correct rate plan or property ID
RATE_EDITABLE_ONLY_ON_EXTRANET Availability Rate is editable only on extranet. set rate plan to XML or update rate plan via Extranet
RATE_ID_DOESNOT_BELONG_TO_ROOM Derived Prices Rate does not belong to this room
RATE_ID_MISSING Derived Prices Rate id is missing use correct rate ID
RATE_ID_NOT_VALID_FOR_HOTEL LOS Pricing Rate id is not valid for hotel
RATE_ID_REQUIRED Availability From date should be less than to date. use rate ID (or activate room level inventory). it can be hard for providers to find out about changes of inventory type since there is no corresponding API to set/get inventory type
RATE_ID_SHOULD_BE_A_NUMBER LOS Pricing Rate id should be a number
RATE_ID_SHOULD_BE_A_POSITIVE_NUMBER Derived Prices Rate id should be a positive number use correct rate ID
RATE_NEGATIVE HotelRateAmountNotif (OTA)
RATE_NOT_ACTIVE Availability,LOS Pricing Rate is not active. activate rate ID for property and room ID
RATE_NOT_ACTIVE_FOR_ROOM Availability,LOS Pricing Rate is not active for room. activate rate ID for property and room ID
RATE_NOT_MATCHING_ROOM Promotions use correct rate ID
REPORT_AND_STAY_CHANGE Reporting
REPORT_OR_STAY_CHANGE Reporting use correct roomreservation ID
REPORT_TYPE_UNKNOWN Reporting
REQUEST_VERSION_INVALID Rooms Request version is invalid
RESERVATION_ALREADY_INVOICED Reporting You cannot mark this credit card as invalid because this reservation has already been invoiced. Please contact Credit Control
RESERVATION_ARCHIVED Reservations
RESERVATION_NOT_QUEUED HotelResNotifSplit (OTA)
RESTRICTION_STATUS_ATTRIBUTE_VALUE_DOES_NOT_MATCH_REGEX HotelAvailNotif (OTA) Attribute values does not match regular expression. Provide RestrictionStatus in the correct format
RESTRICTION_STATUS_MISSING_STATUS_ELEMENT HotelAvailNotif (OTA) RestrictionStatus has missing Status element. Provide RestrictionStatus status element on update
ROOMS_NOT_SELECTED_TO_APPLY_DEAL Promotions Add room to the call
ROOMS_TAG_REQUIRED Derived Prices Rooms tag is required Add room ID to ROOMS element
ROOM_DOES_NOT_BELONG_TO_HOTEL HotelBookingRuleNotif (OTA)
ROOM_DOES_NOT_EXIST Availability,Derived Prices Room does not exist. Provide the correct room ID
ROOM_EDITABLE_ONLY_ON_EXTRANET Availability Room is editable only on extranet. Request property to change room to XML room
ROOM_ID_MISSING Derived Prices Room id is missing Provide relevant room ID
ROOM_ID_NOT_VALID_FOR_HOTEL LOS Pricing Room id is not valid for hotel
ROOM_ID_SHOULD_BE_A_NUMBER LOS Pricing Room id should be a number
ROOM_ID_SHOULD_BE_A_POSITIVE_NUMBER Derived Prices Room id should be a positive number
ROOM_NOT_ACTIVE Availability,LOS Pricing Room is not active. Activate the room
ROOM_NOT_BELONG_TO_RESERVATION Reporting Provide the correct room reservation ID and reservation ID
ROOM_NOT_MATCHING_RATE Promotions Make sure you use a valid product
ROOM_OBJECT_INCORRECT_FORMAT Availability Room object has wrong format.
ROOM_RATES_DONT_EXIST Promotions,Promotions,Promotions
ROUND_SHOULD_BE_A_NUMBER Derived Prices Round should be a number
SHOW_RATES_STATUS_SHOULD_BE_A_NUMBER Rates show_rates_status should be a number
SHOW_RATES_STATUS_SHOULD_BE_NON_NEGATIVE Rates show_rates_status should be non-negative
SHOW_RATE_STATUS_INVALID_FORMAT Room Rates show rate status isn't a valid number
SHOW_RATE_STATUS_NEGATIVE_VALUE Room Rates show rate status is negative expecting zero or positive number
START_DATE_INVALID Room Rate Availability Start date is either invalid or too far in the future. Set a date in near future.
START_END_INVALID Promotions Set the additional date range to less than 30 days
START_END_MISSING Promotions Add start & and attribute for excluded_dates
STAY_CHANGE_EARLY Reporting
STAY_CHANGE_REQ_NODE_MISSING Reporting
STAY_DATE_BEFORE_BOOK_DATE Promotions
STAY_DATE_BEFORE_BOOK_END_DATE Promotions
STAY_DATE_END_BEFORE_STAY_DATE_START Promotions
STAY_DATE_IN_PAST Promotions Use a stay date which has not yet passed
STAY_DATE_START_IN_THE_PAST Promotions
STAY_END_DATE_IN_PAST Promotions
STAY_START_DATE_AFTER_END_DATE Promotions
STAY_START_DATE_IN_PAST Promotions
SYSTEM_ERROR HotelRateAmountNotif (OTA)
TAG_HAS_INVALID_VALUE Availability Tag has invalid value.
TAG_NOT_ALLOWED Availability Tag not allowed inside date block when using room level inventory.
TIME_VALUE_EXCEEDS_FIXED_PATTERN_LENGTH HotelAvailNotif (OTA) Time attribute values are higher than FixedPatternLength
TOO_MANY_AVAILSTATUSMESSAGES_ELEMENT HotelAvailNotif (OTA) Only one AvailStatusMessages element should be present
UNMODIFIABLE_BOOKING Reporting
WARN_PRICE_TOO_LOW_LIMIT HotelRateAmountNotif (OTA),Availability
WARN_PRICE_TOO_LOW_PERCENTAGE HotelRateAmountNotif (OTA),Availability
WARN_TOO_LARGE_NUMBER_ROOMS_TO_SELL Availability