Passages by Location

Endpoint

GET /passages/by-location/:id

Description

Retrieve all sailing passages that either depart from or arrive at a specific location. Useful for showing "Sail from here" options on a location detail page.

Results are sorted by distance (shortest passages first).

Authentication

No authentication required. This is a public endpoint.

Path Parameters

Parameter	Type	Description
`id`	number	Location ID

Query Parameters

Parameter	Type	Required	Description
`limit`	number	No	Max results (default: 20, max: 50)

Example Request

curl "https://charter.boats/api/passages/by-location/4521?limit=5"

Example Response

[
  {
    "id": "route-uuid-1",
    "slug": "lefkas-to-meganisi",
    "title": "Lefkas to Meganisi",
    "description": "Short hop to the charming island of Meganisi...",
    "distance_nm": 8,
    "difficulty": "easy",
    "typical_duration_hours": 1.5,
    "rating": 4.9,
    "rating_count": 22,
    "variant_count": 2,
    "from_location": {
      "id": 4521,
      "name": "D-Marin Lefkas",
      "country_code": "GR"
    },
    "to_location": {
      "id": 4532,
      "name": "Vathi (Meganisi)",
      "country_code": "GR"
    }
  },
  {
    "id": "route-uuid-2",
    "slug": "lefkas-to-vasiliki",
    "title": "Lefkas to Vasiliki",
    "distance_nm": 22,
    "difficulty": "easy",
    "typical_duration_hours": 4,
    "rating": 4.8,
    "rating_count": 15,
    "variant_count": 3,
    "from_location": {
      "id": 4521,
      "name": "D-Marin Lefkas",
      "country_code": "GR"
    },
    "to_location": {
      "id": 4545,
      "name": "Vasiliki",
      "country_code": "GR"
    }
  }
]

Response Fields

Field	Type	Description
`id`	string	Route ID (UUID)
`slug`	string	URL slug
`title`	string	Route title
`description`	string\|null	Route description
`distance_nm`	number\|null	Distance in nautical miles
`difficulty`	string\|null	Difficulty level
`typical_duration_hours`	number\|null	Estimated sailing time
`rating`	number\|null	Average rating
`rating_count`	number\|null	Number of ratings
`variant_count`	number\|null	Number of route variants
`geojson`	object\|null	Route geometry (GeoJSON LineString)
`from_location`	object	Departure location
`from_location.id`	number	Location ID
`from_location.name`	string	Location name
`from_location.country_code`	string	ISO country code
`to_location`	object	Arrival location

Notes

Returns passages where the given location is either the departure or arrival point.
Results are sorted by distance ascending (shortest passages first).
Includes geojson route geometry. Use Get Passage for full details including variants and POIs.

Passages by Location

On this page