Search Trips (AI)

GET/ai/trips

Search community-created and AI-generated sailing itineraries. Useful for trip planning -- includes duration, distance, activities, and ratings. Only public itineraries are returned.

Authentication

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

Query Parameters

Parameter	Type	Required	Description
`location`	string	No	Destination name (fuzzy matched). Finds trips whose route passes through this area.
`location_id`	string	No	Exact location ID
`q`	string	No	Free-text match against the trip title.
`boat_type`	string	No	Filter by boat type used in the itinerary
`min_days`	integer	No	Minimum trip duration in days
`max_days`	integer	No	Maximum trip duration in days
`activities`	string	No	Comma-separated activity filters. Matches trips that include any of these activities. Examples: `swimming,snorkeling`, `nightlife,local_cuisine`
`limit`	integer	No	Max results (default: 5, max: 20)

Request

# Find 7-day itineraries in Greece
curl "https://charter.boats/api/ai/trips?location=Greece&min_days=7&max_days=7"
 
# Sailing trips with snorkeling activities
curl "https://charter.boats/api/ai/trips?location=Lefkada&activities=snorkeling,swimming"

Response

{
  "trips": [
    {
      "id": "a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7",
      "title": "Ionian Island Hopping - 7 Days",
      "start_location": "Lefkada",
      "location": "D-Marin Lefkas, Lefkada, Greece",
      "duration_days": 7,
      "distance_nm": 85,
      "boat_type": "sailboat",
      "activities": ["swimming", "snorkeling", "local_cuisine", "hiking"],
      "rating": 4.7,
      "review_count": 8,
      "favorite_count": 42,
      "url": "https://charter.boats/trips/a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7"
    }
  ]
}

When no trips match (or no public itineraries are linked to the requested area), the response is { "trips": [] }.

Response Fields

Field	Type	Description
`trips`	array	Matching itineraries sorted by rating then favorites
`trips[].id`	string	Trip UUID
`trips[].title`	string	Trip title
`trips[].start_location`	string	Starting location name (free text)
`trips[].location`	string	Resolved location name (marina, city, country). Falls back to `start_location`.
`trips[].duration_days`	integer	Trip duration in days
`trips[].distance_nm`	number\|null	Total distance in nautical miles (`total_distance_nm`)
`trips[].boat_type`	string\|null	Recommended boat type
`trips[].activities`	array	Activities included in the itinerary
`trips[].rating`	number\|null	Average rating
`trips[].review_count`	integer	Number of reviews (0 if none)
`trips[].favorite_count`	integer	Number of users who favorited this trip (0 if none)
`trips[].url`	string	Link to trip page on charter.boats

Trip Details

GET/ai/trips/{id}

Full detail for a single public itinerary, including a condensed day-by-day plan. The {id} must be a trip UUID. Only public trips are accessible to external callers.

Request

curl "https://charter.boats/api/ai/trips/a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7"

Response

{
  "id": "a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7",
  "title": "Ionian Island Hopping - 7 Days",
  "start_location": "Lefkada",
  "location": "D-Marin Lefkas, Lefkada, Greece",
  "start_date": "2026-07-11",
  "end_date": "2026-07-18",
  "duration_days": 7,
  "total_distance_nm": 85,
  "boat_type": "sailboat",
  "activities": ["swimming", "snorkeling", "local_cuisine"],
  "highlights": ["Meganisi caves", "Fiskardo harbour", "Sivota tavernas"],
  "rating": 4.7,
  "review_count": 8,
  "favorite_count": 42,
  "total_sailing_hours": 22,
  "days": [
    {
      "day": 1,
      "date": "2026-07-11",
      "from": "Lefkas Marina",
      "to": "Vathi (Meganisi)",
      "distance_nm": 8,
      "stops": [
        { "name": "Spartochori", "activity": "lunch", "duration": "2h", "notes": null }
      ],
      "notes": "Short first hop, settle into the boat.",
      "recap": null
    }
  ],
  "url": "https://charter.boats/trips/a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7"
}

Response Fields

Field	Type	Description
`id`	string	Trip UUID
`title`	string	Trip title
`start_location`	string	Starting location name (free text)
`location`	string	Resolved location (marina, city, country). Falls back to `start_location`.
`start_date`	string\|null	Planned start date
`end_date`	string\|null	Planned end date
`duration_days`	integer	Trip duration in days
`total_distance_nm`	number\|null	Total distance in nautical miles
`boat_type`	string\|null	Recommended boat type
`activities`	array	Activities included
`highlights`	array	Up to 6 trip highlights
`rating`	number\|null	Average rating
`review_count`	integer	Number of reviews (0 if none)
`favorite_count`	integer	Number of favorites (0 if none)
`total_sailing_hours`	number\|null	Total sailing hours across the trip
`days`	array	Condensed day-by-day plan
`days[].day`	integer	Day number
`days[].date`	string\|null	Date for this day
`days[].from`	string\|null	Start marina/location
`days[].to`	string\|null	End marina/location
`days[].distance_nm`	number\|null	Distance sailed this day
`days[].stops`	array	Up to 6 stops with `name`, `activity`, `duration`, `notes`
`days[].notes`	string\|null	Day notes (trimmed to ~200 chars)
`days[].recap`	string\|null	Day recap (trimmed to ~200 chars)
`url`	string	Link to trip page on charter.boats

Errors

Status	Message
`400`	Valid trip UUID required
`404`	Trip not found (or not public)

Search Trips (AI)

On this page