Destinations report (by destination country)

Overview

Returns analytics on destinations (the country where the hotel is located). Compares the current period to the previous period of equal length, with per-destination booking count, hotel count, sales in USD, average booking value, and period-over-period change.

When to Use

• Destination performance - See which countries (hotel locations) drive the most bookings and sales
• Period comparison - Compare current vs previous period totals and per-destination growth
• Geographic dashboards - Track performance by destination country (ISO code)
• Inventory and commercial planning - Identify growing or declining destinations

What You Get

• Period definition - Date ranges for current and previous periods
• Summary - Total sales (USD), change percent/amount, and count of destination countries
• Per-destination data - For each country: booking count, hotel count, total sales USD, avg booking value; current and previous period; and change (sales percent/amount, booking count change)
• New or inactive destinations - Countries with no previous-period data have previous_period: null; destinations with no current-period activity may have zeros and negative change

Quick Start

Pass query parameters from, to, and sandbox. The API derives the previous period (same length, immediately before). Returns period metadata, summary totals, and an array of destination-level metrics.