Charter Boats
Charter Boats API
Boats

Manufacturers

The makes boats are filed under, and the models each make sells — the values the make/model search filter takes

GET/manufacturers

The makes (boat builders) boats are filed under. Use it to resolve a make to its slug for the makes filter on List Boats, to its id for Smart Defaults, and to its exact name for manufacturer_name on Import Boat.

Authentication

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

Query Parameters

ParameterTypeDescription
categorystringOnly makes tagged with this category: sailboat, catamaran, yacht, speedboat, fishing, pontoon. Most makes carry no category, so this returns a small curated subset, not every builder of that kind of boat
popular1 | trueReturn only the most-used makes (see below)
limitintegerWith popular only: how many makes, 1–50 (default 10). Ignored otherwise

Without popular the full list comes back (about 1,900 active makes), sorted by name.

With popular, the makes with the most boats in the catalogue are picked — generic placeholders (Custom, Other, Unknown, …) excluded — and each carries a boat_count. The picked makes are then returned sorted by name, not by count.

Responses are cached for an hour.

Request

# Every make
curl "https://charter.boats/api/manufacturers" \
  -H "X-API-Key: YOUR_API_KEY"
 
# The three most-used catamaran makes
curl "https://charter.boats/api/manufacturers?category=catamaran&popular=1&limit=3" \
  -H "X-API-Key: YOUR_API_KEY"

Response

An array of makes.

[
  {
    "id": "c581bcca-cc2c-441c-9b28-4fb22f97fa99",
    "name": "Bali",
    "slug": "bali",
    "logo_url": null,
    "country": "France",
    "category": "catamaran",
    "aliases": [],
    "boat_count": 1283
  },
  {
    "id": "8425d598-5ce9-40c2-ab30-6018cfe797d9",
    "name": "Fountaine Pajot",
    "slug": "fountaine-pajot",
    "logo_url": null,
    "country": "France",
    "category": "catamaran",
    "aliases": ["FP"],
    "boat_count": 1054
  }
]
FieldTypeDescription
idstringMake UUID
namestringDisplay name
slugstringStable identifier — what the makes filter takes
logo_urlstring|nullLogo, when we hold one (an external URL)
countrystring|nullCountry of the builder
categorystring|nullCurated category, when tagged
aliasesstring[]Other names the trade uses for this make (FP for Fountaine Pajot)
boat_countintegerWith popular only: boats in the catalogue filed under this make, listed or not. A popularity signal — not the number of boats a search will return

Get one make

GET/manufacturers/:slug

One active make by slug, with its full record.

curl "https://charter.boats/api/manufacturers/bali" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "id": "c581bcca-cc2c-441c-9b28-4fb22f97fa99",
  "name": "Bali",
  "slug": "bali",
  "logo_url": null,
  "website": "https://www.bali-catamarans.com",
  "country": "France",
  "category": "catamaran",
  "parent_company": "Catana Group",
  "description": "Innovative catamarans with signature pivoting aft door",
  "is_active": true,
  "aliases": [],
  "created_at": "2026-01-27T18:21:34.61686+00:00"
}

The record may carry further internal columns (partner-platform ids); rely only on the fields above.

StatusMessage
404Manufacturer not found

Models of a make

GET/manufacturers/:slug/models

The models of one make that have at least one published boat — the values for the slug:model form of the makes filter on List Boats. No counts: how many boats match depends on the rest of your search.

curl "https://charter.boats/api/manufacturers/bali/models" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "manufacturer": { "id": "c581bcca-cc2c-441c-9b28-4fb22f97fa99", "name": "Bali", "slug": "bali" },
  "models": [
    { "id": "013d8ee6-8072-4115-8126-606c8d676523", "label": "4.2", "values": ["4.2"] },
    { "id": "71e0be3d-180c-4ab5-a2c9-a33309bf7f2f", "label": "4.2 OW", "values": ["4.2 OW", "4.2 ow"] }
  ]
}
FieldTypeDescription
manufacturerobject{ id, name, slug }
models[].idstringModel UUID
models[].labelstringThe model's name — pass this in the filter: makes=bali:4.2
models[].valuesstring[]Every spelling boats of this model are stored under. Use it to match a raw model string from a boat record back to its model

Partner feeds disagree about spelling (a Bali 4.2 arrives as both 4.2 and Bali 4.2); a label covers all of them, which a raw model string would not. Variants that differ in layout — the 4.2 OW has fewer cabins than the 4.2 — are separate models.

Cached for an hour.

StatusMessage
404Manufacturer not found

On this page