---
title: "Guest nationality (source market) report"
method: GET
path: "/bookings/guest-nationality-report"
tags: ["Analytics"]
---

# Guest nationality (source market) report

`GET /bookings/guest-nationality-report`

## Overview

Returns analytics on the source markets (guest nationality) of bookings. Compares the current period to the previous period of equal length, with per-nationality booking counts, sales in USD, average booking value, and period-over-period change.

## When to Use

- **Source market analysis** - See which nationalities drive the most bookings and sales
- **Period comparison** - Compare current vs previous period totals and per-nationality growth
- **Geographic dashboards** - Track performance by guest country (ISO code)
- **Marketing and sales planning** - Identify growing or declining markets

## What You Get

- **Period definition** - Date ranges for current and previous periods
- **Summary** - Total sales (USD), change percent/amount, and count of nationalities
- **Per-nationality data** - For each guest nationality: booking count, total sales USD, avg booking value; current and previous period; and change (sales percent/amount, booking count change)
- **New markets** - Nationalities with no previous-period data have `previous_period: null` and change expressed as 100% growth

## 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 nationality-level metrics.

## Query parameters

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

## Response `200`

Guest nationality 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/versions/315ba2a4dcf4/schema)