booking-com · Schema

Booking.com Promotion

Represents a promotional offer on Booking.com, including deals, discounts, and special rates that properties use to attract travelers and increase bookings.

Properties

Name Type Description
promotion_id string Unique identifier for the promotion
promotion_type string Type of promotional offer
hotel_id integer Booking.com property identifier this promotion applies to
discount_percentage number Discount percentage applied to the parent rate
status string Current status of the promotion
bookable_from string Start date from which the promotion can be booked
bookable_until string End date until which the promotion can be booked
stay_from string Earliest check-in date for stays using this promotion
stay_until string Latest check-out date for stays using this promotion
min_advance_days integer Minimum number of days in advance the booking must be made
max_advance_days integer Maximum number of days in advance the booking can be made
min_stay_nights integer Minimum number of nights required for the stay
applicable_rooms array Room type IDs this promotion applies to; empty means all rooms
applicable_rates array Rate plan IDs this promotion applies to; empty means all rates
target_countries array Country codes eligible for this promotion (country_rate type only)
target_devices array Device types eligible for this promotion (mobile_rate type only)
campaign_name string Name of the campaign (campaign_deal type only)
created_at string Timestamp when the promotion was created
modified_at string Timestamp when the promotion was last modified
View JSON Schema on GitHub