Get Boat

GET/boats/:id

Retrieve complete details for a single boat, including company info, location, images, amenities, reviews, seasonal pricing, and calculated ratings.

Authentication

No authentication required. This is a public endpoint.

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	The boat's unique identifier (UUID)

Request

curl https://charter.boats/api/boats/550e8400-e29b-41d4-a716-446655440000

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "title": "BALI Catspace - Luxury Catamaran",
  "description": "Beautiful 40ft catamaran with 4 cabins...",
  "boat_type": "catamaran",
  "capacity": 8,
  "cabins": 4,
  "crew_cabins": 0,
  "berths": 8,
  "toilets": 2,
  "length_ft": 40,
  "year": 2023,
  "rental_type": "bareboat",
  "charter_day": "saturday",
  "check_in_periods": "weekly",
  "checkin_time": "17:00",
  "checkout_time": "09:00",
  "min_charter_days": 7,
  "instant_book": false,
  "security_deposit": 2500,
  "cancellation_policy": "moderate",
  "price_per_day": 850,
  "price_from": 750,
  "price_to": 1200,
  "original_price_per_day": null,
  "discount_percentage": null,
  "discount_label": null,
  "best_price": 850,
  "best_source": "direct",
  "best_currency": "EUR",
  "average_rating": 4.8,
  "review_count": 2,
  "pricing_source": "direct",
  "is_published": true,
  "is_active": true,
  "company": {
    "id": "company-uuid",
    "name": "Sail Greece",
    "slug": "sail-greece",
    "logo_url": "https://...",
    "description": "Premium charter company...",
    "is_verified": true,
    "base_currency": "EUR"
  },
  "location": {
    "id": 42,
    "name": "Lefkada Marina",
    "city": "Lefkada",
    "municipality": "Lefkada",
    "country": "Greece",
    "country_code": "GR",
    "lat": 38.8336,
    "lon": 20.7066,
    "website": "https://...",
    "phone": "+30...",
    "image_url": "https://...",
    "rating": 4.5,
    "capacity": 200,
    "max_draft": 4.5,
    "max_length": 30,
    "vhf_channel": "09",
    "neighbors": [43, 44]
  },
  "manufacturer": {
    "id": "mfr-uuid",
    "name": "Bali Catamarans",
    "slug": "bali-catamarans",
    "logo_url": "https://..."
  },
  "images": [
    {
      "id": "img-uuid",
      "url": "https://...",
      "category": "exterior",
      "is_primary": true,
      "sort_order": 0
    }
  ],
  "videos": [],
  "amenities": [
    {
      "id": "amenity-uuid",
      "name": "WiFi",
      "icon": "wifi",
      "category": "entertainment"
    }
  ],
  "reviews": [
    {
      "id": "review-uuid",
      "rating": 5,
      "comment": "Amazing experience!",
      "created_at": "2026-01-20T00:00:00Z"
    }
  ],
  "seasons": [
    {
      "id": "season-uuid",
      "name": "High Season",
      "start_month": 7,
      "start_day": 1,
      "end_month": 8,
      "end_day": 31,
      "price_per_day": 1200,
      "original_price_per_day": null,
      "discount_percentage": null,
      "discount_name": null,
      "valid_from_year": 2026,
      "valid_to_year": 2026,
      "source": "direct"
    }
  ]
}

Response Fields

Field	Type	Description
`id`	string	Unique boat identifier (UUID)
`title`	string	Boat name
`description`	string	Full description
`boat_type`	string	`yacht`, `catamaran`, `sailboat`, `motorboat`, `rib`, or `other`
`capacity`	integer	Maximum guests
`cabins`	integer	Number of cabins
`crew_cabins`	integer	Number of crew cabins
`berths`	integer	Number of berths
`toilets`	integer	Number of toilets
`length_ft`	number	Length in feet
`year`	integer	Year built
`rental_type`	string	`bareboat`, `skippered`, or `no_licence_needed`
`charter_day`	string	Preferred charter start day (e.g. `saturday`)
`check_in_periods`	string	Check-in period type (e.g. `weekly`)
`checkin_time`	string	Check-in time (e.g. `17:00`)
`checkout_time`	string	Check-out time (e.g. `09:00`)
`min_charter_days`	integer	Minimum charter duration in days
`instant_book`	boolean	Whether instant booking is enabled
`security_deposit`	number	Security deposit amount
`cancellation_policy`	string	`flexible`, `moderate`, or `strict`
`price_per_day`	number	Daily rate
`price_from`	number	Lowest seasonal price
`price_to`	number	Highest seasonal price
`original_price_per_day`	number\|null	Original price before discount
`discount_percentage`	number\|null	Active discount percentage
`discount_label`	string\|null	Discount label text
`best_price`	number	Best available daily price
`best_source`	string	Pricing source: `direct`, `nausys`, or `mmk`
`best_currency`	string	Currency code (e.g. `EUR`)
`pricing_source`	string	Active pricing source for this boat
`average_rating`	number\|null	Calculated average rating (1-5)
`review_count`	integer	Total number of reviews
`company`	object	Company details (see below)
`location`	object	Marina/location details (see below)
`manufacturer`	object\|null	Manufacturer details
`images`	array	Boat images (hidden images filtered out)
`videos`	array	Boat videos
`amenities`	array	Amenity objects with `id`, `name`, `icon`, `category`
`reviews`	array	Reviews with `id`, `rating`, `comment`, `created_at`
`seasons`	array	Seasonal pricing periods (filtered by active pricing source)

Company Object

Field	Type	Description
`id`	string	Company UUID
`name`	string	Company name
`slug`	string	URL-friendly identifier
`logo_url`	string\|null	Company logo
`description`	string\|null	Company description
`is_verified`	boolean	Whether the company is verified
`base_currency`	string	Default currency (e.g. `EUR`)

Location Object

Field	Type	Description
`id`	integer	Location ID
`name`	string	Marina/location name
`city`	string	City
`municipality`	string	Municipality
`country`	string	Country name
`country_code`	string	ISO country code
`lat`	number	Latitude
`lon`	number	Longitude

Errors

Status	Message
`400`	Boat ID is required
`404`	Boat not found

Get Boat

On this page