Feature Vocabulary

The canonical vocabulary accepted by the features filter on List Boats: 58 concept slugs plus namespaced attribute tags that refine a concept (dinghy:hypalon refines dinghy). Filtering with an attribute tag matches only boats whose equipment carries that specific trait.

Authentication

No authentication required for server-side requests — this is a public read endpoint.

Query Parameters

Response (vocabulary mode)

Features arrive grouped by display section (in groups order) and sorted rarest-first within each group — render them in the order given.

{
  "features": [
    {
      "slug": "dinghy",
      "label": "Dinghy / tender",
      "synonyms": ["tender", "zodiac"],
      "group": "Deck",
      "attributes": [
        { "tag": "dinghy:hard_bottom", "label": "Hard-bottom (RIB)", "synonyms": ["hard bottom dinghy", "rigid dinghy", "rib tender", "hard bottom"] },
        { "tag": "dinghy:hypalon", "label": "Hypalon", "synonyms": ["hypalon dinghy", "hypalon tender"] }
      ]
    }
  ],
  "groups": ["Rigging", "Deck", "Navigation", "Comfort", "Interior", "Electric", "Entertainment", "Activities", "Safety", "Other"]
}

Boat counts are deliberately absent here — counts depend on the search context, so fetch them per search via facet_counts=1 on List Boats.

Response (suggest mode)

?q= resolves free text to canonical values: concept labels and synonyms, attribute labels and synonyms, and real fleet equipment wordings ("webasto" resolves to Heating because boats list Webasto heaters). When a wording produced the match it is returned as a hint.

curl "https://charter.boats/api/features?q=webasto"

{
  "suggestions": [
    { "value": "heating", "label": "Heating", "hint": null },
    { "value": "air_conditioning", "label": "Air conditioning", "hint": "A/C + Webasto" }
  ]
}