CalryOTA Docs
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.

GET
/api/v1/listing/locations

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.

Default50
Range1 <= value <= 200

Header 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": []
}