---
title: "Properties (hotels) sales report"
method: GET
path: "/bookings/hotels-sales-report"
tags: ["Analytics"]
---

# Properties (hotels) sales report

`GET /bookings/hotels-sales-report`

## Overview

Returns analytics on **properties** (hotels): per-hotel sales, buying price, profit, and profit margin. Compares the current period to the previous period of equal length. Results are ordered by current-period sales (highest first) and limited by the `limit` parameter.

## When to Use

- **Property performance** - See which hotels drive the most sales and profit
- **Period comparison** - Compare current vs previous period sales, profit, and bookings per hotel
- **Profit analysis** - Track total_buying_price_usd, total_profit_usd, and profit_margin_percent by property
- **Top properties dashboards** - Rank hotels by sales or profit

## What You Get

- **Period definition** - Date ranges for current and previous periods
- **Summary** - Totals for sales (USD), profit (USD), bookings, count of hotels in the result, and average profit margin percent; all with period-over-period change
- **Per-hotel data** - For each property: hotel_id, hotel_name, city, country; current and previous period (booking_count, total_sales_usd, avg_booking_value_usd, total_buying_price_usd, total_profit_usd, profit_margin_percent); and change (sales/profit percent and amount, booking_count_change)
- **New properties** - Hotels with no previous-period data have `previous_period: null`

## Quick Start

Pass query parameters `from`, `to`, `sandbox`, and optionally `limit` (default controls how many top hotels are returned). The API derives the previous period (same length, immediately before). Returns period metadata, summary totals, and an array of hotel-level metrics.

## Query parameters

- `from` string, date, required
- `to` string, date, required
- `sandbox` string
- `limit` integer

## Response `200`

Properties (hotels) sales report retrieved successfully

---

[API](https://skmtc.net/liteapi/apis/api-search.md) · [All operations](https://skmtc.net/liteapi/apis/api-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liteapi/api-search/revisions/315ba2a4dcf4/schema)