Creating a Country Rate
Creates a geo-targeted promotion that offers percentage-based discounts to users from a specific country or region, optionally with last-minute booking conditions.
Attributes
hotel_id string (Required)
Specifies the required node hotel_id contains the IT provider's hotel id for which the provider wishes to add promotion.
channel_hotel_id string (Required)
Specifies the unique hotel ID used in the external distribution channel or PMS (Property Management System).
name string (Required)
The name of the promotion. This name is only for you: it does not appear on Booking.com.
Must be 255 characters or less. This includes spaces.
type string (Required)
The type of promotion.
Should be geo_rate for Country rate.
target_channel string (Optional)
Determines who can see the promotion.
For country rates, it should be india_pos
To get a list of target_channel values, see Retrieve Promotion Types API. Not all properties are eligible to use all target channels.
min_stay_through integer (Optional)
The minimum number of nights a guest must stay to be eligible for the promotion.
Accepts: 1–30.
discount object (Required)
Contains discount configuration details for the promotion.
value number (Required)
The discount percentage applied to the promotion.
Accepts: 5–30.
stay_date object (Required)
The range of dates during which guests must stay at the property to receive the promotion
excluded_dates array[string] (YYYY-MM-DD) (Optional)
A range of dates during which guests staying at the property will not receive the promotion.
last_minute object (Required)
Specifies the unit and value of time before guest's check-in during which the promotion applies.
unit string (Required)
The unit of time specified in days or hours.
Accepts: day.
value integer (Required)
The amount of time (in days) before guest's check-in during which the promotion applies.
Accepts: 1–365.
parent_rates array[integer] (Required)
List of parent rate plan IDs to which the promotion applies. Each value represents a unique rate plan identifier.
Sample Request
Response
Success Response - Body Elements
Status string
Indicates the result of the API call.
Will be "Success" for successful operations.
Message string
A message receives within the response body. This will generally be an empty string if no additional information is needed.
Ruid string
Specifies the unique request ID.
Data object
An object containing data related to the successful promotion creation. This typically includes identifiers for the created promotions.
promotion_id string
The newly created promotion ID.
Errors Response - Body Elements
Errors Response - Body Elements
Status string
Indicates the result of the API call.
"Fail" – The request was not processed successfully due to validation errors or other issues.
Errors array[object]
A list of error objects providing detailed information about one or more issues encountered during request processing. This field may be empty if the error is conveyed through the Message field.
Code string
A unique error code representing the specific type of validation or processing error.
ShortText string
A brief, human-readable description of the error. Typically explains what went wrong and may include accepted values or constraints.
Message string
A descriptive error message summarizing the failure.
Ruid string
A unique request identifier generated for tracking and debugging purposes. This value should be provided when contacting support for issue investigation.
Last updated
Was this helpful?