Skip to main content

​
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 "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

[
  { "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.