Search Routes (AI)

Find sailing passages between destinations with distance, difficulty, and ratings

GET/ai/routes

Search point-to-point sailing passages with distance, difficulty, and community ratings. Routes may have multiple variants (direct, scenic, sheltered). Distances are in nautical miles.

Authentication

No authentication required. Rate limited to 60 requests per 10 minutes.

Query Parameters

Parameter	Type	Required	Description
`from`	string	No	Starting location name (fuzzy matched against name + city). Use this OR `location_id`.
`location_id`	string	No	Exact location ID. Finds routes starting or ending at this location.
`q`	string	No	Free-text match against the route title.
`difficulty`	string	No	Filter by difficulty (e.g. `easy`, `moderate`, `challenging`)
`limit`	integer	No	Max results (default: 5, max: 20)

Request

# Find routes from Sivota
curl "https://charter.boats/api/ai/routes?from=Sivota&limit=5"
 
# Easy routes from a specific location
curl "https://charter.boats/api/ai/routes?location_id=4521&difficulty=easy"

Response

{
  "routes": [
    {
      "id": "7f71404b-e5a5-403c-92b1-93e4a462da42",
      "title": "Sivota to Anchorage",
      "from": "Sivota, Greece",
      "to": "Anchorage, Greece",
      "distance_nm": 5.3,
      "estimated_hours": 1.1,
      "difficulty": null,
      "rating": null,
      "variant_count": 1,
      "description": null,
      "url": "https://charter.boats/routes/sivota-to-anchorage"
    }
  ]
}

difficulty, rating, and description are frequently null — they are only populated for curated routes.

Response Fields

Field	Type	Description
`routes`	array	Matching routes sorted by rating
`routes[].id`	string	Route UUID
`routes[].title`	string	Route title
`routes[].from`	string	Departure location (name, country)
`routes[].to`	string	Arrival location (name, country)
`routes[].distance_nm`	number\|null	Distance in nautical miles
`routes[].estimated_hours`	number\|null	Estimated sailing time at 5 knots average
`routes[].difficulty`	string\|null	Difficulty level
`routes[].rating`	number\|null	Average community rating
`routes[].variant_count`	integer\|null	Number of route variants (direct, scenic, etc.)
`routes[].description`	string\|null	Route description
`routes[].url`	string	Link to route page on charter.boats