Get Smart Defaults

GET/boats/defaults

Get typical specifications (cabins, berths, capacity, price range) for boats based on manufacturer and model. Useful for auto-filling forms when listing a new boat.

Authentication

No authentication required. This is a public endpoint.

Query Parameters

Parameter	Type	Required	Description
`manufacturer_id`	string	No	Manufacturer UUID
`model`	string	No	Model name (case-insensitive match)

If neither parameter is provided, generic defaults are returned.

Request

# Get defaults for a specific manufacturer and model
curl "https://charter.boats/api/boats/defaults?manufacturer_id=abc-123&model=Oceanis%2046.1"
 
# Get defaults for a manufacturer only
curl "https://charter.boats/api/boats/defaults?manufacturer_id=abc-123"
 
# No parameters — returns generic fallback defaults
curl "https://charter.boats/api/boats/defaults"

Response

With matching boats found

{
  "cabins": 4,
  "berths": 8,
  "toilets": 2,
  "capacity": 10,
  "length_ft": 46,
  "year": 2022,
  "price_low": 850,
  "price_high": 1200,
  "common_amenities": [
    "amenity-uuid-1",
    "amenity-uuid-2"
  ],
  "boat_count": 12
}

Without parameters or no matching boats

{
  "cabins": null,
  "berths": null,
  "toilets": null,
  "capacity": 6,
  "length_ft": null,
  "year": 2021,
  "price_low": null,
  "price_high": null,
  "common_amenities": []
}

Response Fields

Field	Type	Description
`cabins`	number\|null	Most common number of cabins among matching boats
`berths`	number\|null	Most common number of berths
`toilets`	number\|null	Most common number of toilets
`capacity`	number	Most common guest capacity (defaults to 6)
`length_ft`	number\|null	Most common length in feet
`year`	number	Most common build year (defaults to 5 years ago)
`price_low`	number\|null	25th percentile daily price
`price_high`	number\|null	75th percentile daily price
`common_amenities`	array	Amenity IDs found in >50% of matching boats
`boat_count`	number	Number of published boats used for the statistics. Only present when matching boats were found.

Notes

Values are calculated from published boats matching the given manufacturer/model
Statistics use the mode (most common value) for specs and percentiles for price range
Returns null for fields without sufficient data
Up to 100 matching boats are sampled for calculations

Get Smart Defaults

On this page