List Passages

Endpoint

GET /passages

Description

List sailing passages (routes between two locations) with optional filtering by location and difficulty. Each passage includes distance, difficulty rating, and departure/arrival location details.

Authentication

No authentication required. This is a public endpoint.

Query Parameters

Parameter	Type	Required	Description
`location_id`	number	No	Filter passages that start or end at this location
`difficulty`	string	No	Filter by difficulty level
`sort`	string	No	Sort order: `distance` (default), `rating`, or `variants`
`limit`	number	No	Max results (default: 50, max: 100)
`offset`	number	No	Pagination offset (default: 0)

Example Request

curl "https://charter.boats/api/passages?sort=rating&limit=10"

Example Response

[
  {
    "id": "route-uuid-1",
    "slug": "lefkas-to-vasiliki",
    "title": "Lefkas to Vasiliki",
    "description": "A scenic day sail down the east coast of Lefkada...",
    "distance_nm": 22,
    "difficulty": "easy",
    "typical_duration_hours": 4,
    "rating": 4.8,
    "rating_count": 15,
    "variant_count": 3,
    "geojson": { "type": "LineString", "coordinates": [...] },
    "from_location": {
      "id": 4521,
      "name": "D-Marin Lefkas",
      "country_code": "GR",
      "lat": 38.8335,
      "lon": 20.7068
    },
    "to_location": {
      "id": 4545,
      "name": "Vasiliki",
      "country_code": "GR",
      "lat": 38.6309,
      "lon": 20.5897
    },
    "created_at": "2026-01-10T08:00:00Z",
    "updated_at": "2026-02-20T14:30:00Z"
  }
]

Response Fields

Field	Type	Description
`id`	string	Route ID (UUID)
`slug`	string	URL-friendly 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 in hours
`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
`from_location.lat`	number	Latitude
`from_location.lon`	number	Longitude
`to_location`	object	Arrival location

Sort Options

Value	Description
`distance`	Shortest passages first (default)
`rating`	Highest rated first
`variants`	Most route variants first

List Passages

On this page