Listing
List every destination city across the portfolio
Returns one entry per distinct city across ALL of the requesting tenant's ACTIVE listings — not just one page of search results. Each entry carries the centroid of that city's listings and the bounding box of those listings, so a client can center and frame a map on it (map zoom is derived client-side from the bounds). Ordered by listing count descending, capped by limit.
Authorization
x-calry-api-key x-calry-api-key<token>
In: header
Query Parameters
limit?number
Maximum number of destinations to return, ordered by listing count descending.
Default
50Range
1 <= value <= 200Header Parameters
x-calry-tenant-id?string
Optional tenant ID to specify which tenant to operate as. If not provided, the default tenant will be used.
Response Body
application/json
application/json
curl -X GET "https://example.com/api/v1/listing/locations"[
{
"name": "string",
"country": "string",
"lat": 0,
"lng": 0,
"bounds": {
"north": 0,
"south": 0,
"east": 0,
"west": 0
},
"listingCount": 0
}
]{
"timestamp": "2025-03-05T11:45:49.631Z",
"path": "<URL_PATH>",
"message": "Authentication failed",
"details": []
}