Booking Destinations

Return booking revenue totals grouped by destination country.

Method

GET /v1/analytics/bookings/destinations

Query Parameters

from · string · required

Start date (YYYY-MM-DD, inclusive).

to · string · required

End date (YYYY-MM-DD, inclusive).

workspaceId · uuid · required

Workspace identifier.

Headers

Authorization · string

Bearer token with analytics:read scope.

Request Example

cURL

curl "https://api.voyantcloud.com/v1/analytics/bookings/destinations?from=2025-02-01&to=2025-02-07&workspaceId=ws_abc" \
  -H "Authorization: Bearer $VOYANT_API_KEY"

Response

200 OK

[
  { "day": "2025-02-01", "country": "RO", "amount_cents_sum": 980000, "cnt": 4 },
  { "day": "2025-02-01", "country": "GR", "amount_cents_sum": 650000, "cnt": 3 },
  { "day": "2025-02-02", "country": "IT", "amount_cents_sum": 420000, "cnt": 2 }
]

Country codes follow ISO 3166-1 alpha-2. Use them to build destination heatmaps or top-destination leaderboards.