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 for server-side requests — this is a public read endpoint. (A key is only needed for cross-origin calls made from a browser on another domain; see Authentication.)

Query Parameters

Parameter	Type	Required	Description
`manufacturer_id`	string	No	Manufacturer UUID
`model`	string	No	Model name (case-insensitive match)
`year`	number	No	Build year. Only affects `length_ft`, and only for the few models whose name covers two generations of hull.

If neither manufacturer_id nor model 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": 2,
  "berths": 6,
  "toilets": 2,
  "capacity": 6,
  "length_ft": 43.5,
  "year": 2008,
  "price_low": 221.21,
  "price_high": 335.79,
  "common_amenities": [],
  "boat_count": 100
}

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	Length overall (LOA) in feet for the model. Not a statistic over the sampled boats — it comes from the canonical model-length library, so every listing of a model reports the same figure. Falls back to the most common length among matching boats when the model isn't in the library.
`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
length_ft is the exception: length is a property of the model, so it is resolved against the canonical model-length library rather than averaged. It therefore answers for variant-suffixed names (Cruiser 46 - 3 cab.) that match no boat by name, and it can be non-null even when boat_count is absent.
Returns null for fields without sufficient data
Up to 100 matching boats are sampled for calculations

Get Smart Defaults

On this page