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

Send your API key in the X-API-Key header, as on every Operator API call — see Authentication.

Query Parameters

Parameter	Type	Required	Description
`manufacturer_id`	string	No	Manufacturer UUID (from `GET /api/manufacturers`)
`model`	string	No	Model name. Matched against each boat's stored model string exactly, ignoring case — `Oceanis 46.1` does not match a boat filed as `Beneteau Oceanis 46.1` or `Oceanis 46.1 (4 cab)`

If neither manufacturer_id nor model is provided, generic defaults are returned.

Request

# Get defaults for a specific manufacturer and model (Beneteau Oceanis 46.1)
curl "https://charter.boats/api/boats/defaults?manufacturer_id=1c0513d4-45a3-46e9-80eb-b891e12652d8&model=Oceanis%2046.1" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Get defaults for a manufacturer only
curl "https://charter.boats/api/boats/defaults?manufacturer_id=1c0513d4-45a3-46e9-80eb-b891e12652d8" \
  -H "X-API-Key: YOUR_API_KEY"
 
# No parameters — returns generic fallback defaults
curl "https://charter.boats/api/boats/defaults" \
  -H "X-API-Key: YOUR_API_KEY"

Response

With matching boats found

{
  "cabins": 5,
  "berths": 10,
  "toilets": 3,
  "capacity": 10,
  "length_ft": 44.8,
  "year": 2020,
  "price_low": 280.07,
  "price_high": 394.03,
  "common_amenities": [
    "26b70ce7-fa6d-4304-abd7-8c6fd7437ac0",
    "4e6f5809-2086-4841-b642-fe0a63abfd58"
  ],
  "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. When both `manufacturer_id` and `model` are sent and the model is in the canonical model-length library, it is the library's figure — every listing of that model reports the same number. Otherwise (only one of the two sent, or a model the library doesn't know) it is the most common length among the sampled boats.
`year`	number	Most common build year (defaults to 5 years ago)
`price_low`	number\|null	25th percentile daily price, in EUR
`price_high`	number\|null	75th percentile daily price, in EUR
`common_amenities`	array	IDs from the legacy amenity list carried by at least half of the sampled boats. Not the `features` vocabulary — see Feature Vocabulary
`boat_count`	number	Number of published boats sampled — at most 100. 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 with both manufacturer_id and model it is resolved against the canonical model-length library rather than taken from the sample. 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
At most 100 matching boats are sampled, so for a large make (manufacturer_id alone) the figures describe a sample of its fleet, not all of it — boat_count then reads 100. The sample is the same 100 on every call (the fleet is cut in id order), so the same request answers with the same figures until the fleet itself changes

Get Smart Defaults

On this page