Get Boat

Retrieve complete details for a single boat, including location, images, equipment, reviews, seasonal pricing, and calculated ratings.

Authentication

Send your API key in the X-API-Key header, as on every Operator API call. It reads only boats your company operates; another operator's boat is a 403 — sell those through the Discovery API. See Authentication.

Responses are cached for 60 seconds (served stale while refreshing), so a change can take up to a minute to show.

Path Parameters

Request

# By UUID
curl https://charter.boats/api/boats/3a121be0-c1f8-4432-8e18-4a125b46da65 \
  -H "X-API-Key: YOUR_API_KEY"
 
# By slug
curl https://charter.boats/api/boats/beneteau-oceanis-393-skuribanda-5b46da65 \
  -H "X-API-Key: YOUR_API_KEY"

Response

Trimmed: long arrays are shortened and some location fields omitted.

{
  "id": "3a121be0-c1f8-4432-8e18-4a125b46da65",
  "slug": "beneteau-oceanis-393-skuribanda-5b46da65",
  "title": "Škuribanda",
  "boat_type": "sailboat",
  "mmsi": null,
  "capacity": 6,
  "length_ft": 39.2,
  "year": 2006,
  "cabins": 3,
  "crew_cabins": 0,
  "berths": 6,
  "toilets": 2,
  "specs": {
    "beam": 3.96,
    "draft": 1.9,
    "engine_desc": "Volvo 56 hp",
    "transit_log": 270,
    "fuel_capacity": 150,
    "water_capacity": 500
  },
  "specs_from_model": [],
  "ais": null,
  "description": null,
  "description_ai": null,
  "pricing_source": "mmk",
  "price_per_day": 133.98,
  "original_price_per_day": 231,
  "discount_percentage": 40,
  "discount_label": "40% discount",
  "price_from": 133.98,
  "price_to": 264.6,
  "charter_day": 6,
  "check_in_periods": [
    {
      "dateTo": "31.12.2099",
      "dateFrom": "01.01.2020",
      "checkInDays": [6],
      "checkInTime": "17:00",
      "checkOutDays": [6],
      "checkOutTime": "09:00",
      "minimalReservationDuration": 7
    }
  ],
  "checkin_time": "17:00:00",
  "checkout_time": "08:30:00",
  "min_charter_days": 7,
  "instant_book": true,
  "security_deposit": 1500,
  "deposit_with_waiver": null,
  "seo_released_at": "2026-06-24T07:15:08.279+00:00",
  "location_id": 20810,
  "model": "Oceanis 393",
  "updated_at": "2026-09-09T16:29:20.313929+00:00",
  "features": ["autopilot", "chartplotter", "deck_shower", "dinghy", "electric_windlass", "solar_panels"],
  "manufacturer_id": "1c0513d4-45a3-46e9-80eb-b891e12652d8",
  "rental_type": "skippered",
  "skipper": 1,
  "skipper_charged": false,
  "skipper_for_hire": false,
  "crew": null,
  "average_rating": null,
  "review_count": 0,
  "is_published": true,
  "photo_descriptions": {
    "deck": "Relax on the spacious aft deck, perfect for sunbathing or scenic views.",
    "lounge": "Inviting salon features a comfortable dining area and dedicated navigation station."
  },
  "seo_variant": "A",
  "has_valid_name": true,
  "has_multi_port": false,
  "hero_image_url": "https://…/boats/3a121be0-c1f8-4432-8e18-4a125b46da65/images/1772350897275_0b0ba49e.jpg",
  "tour_360": null,
  "avail_weeks": 1125341561094160,
  "avail_weeks_anchor": "2026-09-05",
  "discounted_price_per_day": [0, 0, 0, 0, 154, 0, "…", 219, 203, 0, 0],
  "discount_pct": [0, 0, 0, 0, 42, 0, "…", 42, 42, 0, 0],
  "extras_per_day": [0, 0, 0, 0, 170, 0, "…", 170, 170, 0, 0],
  "extras_per_booking": [0, 0, 0, 0, 360, 0, "…", 360, 360, 0, 0],
  "extras_per_person": [0, 0, 0, 0, 0, 0, "…", 0, 0, 0, 0],
  "extras_per_person_per_day": [0, 0, 0, 0, 1, 0, "…", 1, 1, 0, 0],
  "best_internal_discount_pct": 0,
  "company": {
    "base_currency": "EUR",
    "cancel_refund_days": 30,
    "cancel_refund_percent": 50,
    "terms_guest": {
      "insurance_requirements": "All vessels covered with Kasko insurance...",
      "damage_liability": "Client liable for all damage...",
      "license_requirements": "Client must have original navigation licenses..."
    },
    "terms_faq": [
      { "q": "Can I bring pets aboard?", "a": "Pets such as dogs, cats, or birds are only allowed with our prior written consent..." }
    ]
  },
  "manufacturer": {
    "id": "1c0513d4-45a3-46e9-80eb-b891e12652d8",
    "name": "Beneteau",
    "slug": "beneteau",
    "logo_url": null
  },
  "location": {
    "id": 20810,
    "slug": "marina-zenta-split",
    "name": "Marina Zenta, Split",
    "city": "Split",
    "municipality": null,
    "state": null,
    "country": "Croatia",
    "country_code": "hr",
    "lat": 43.49955,
    "lon": 16.45676,
    "rating": 3.7,
    "neighbors": null,
    "description": "Marina Zenta sits just east of Split's main port in the sheltered Zenta bay..."
  },
  "geo_crumbs": [
    { "label": "Croatia", "href": "/locations/country/croatia" },
    { "label": "Dalmatia", "href": "/locations/region/dalmatia" },
    { "label": "Split", "href": "/locations/city/split" }
  ],
  "images": [
    {
      "id": "d0a4be7a-0950-471c-9f03-2acb4bfcd2d2",
      "url": "https://…/boats/3a121be0-c1f8-4432-8e18-4a125b46da65/images/1772350897682_d0a4be7a.jpg",
      "category": "cockpit",
      "is_active": true,
      "is_primary": false,
      "sort_order": 2
    }
  ],
  "videos": [],
  "equipment": [
    {
      "group": "Deck",
      "items": [
        { "name": "Gangway", "value": null },
        { "name": "Teak deck (cockpit)", "value": null },
        { "name": "Dinghy", "value": null }
      ]
    }
  ],
  "rare_features": [],
  "reviews": [],
  "prices": [
    {
      "id": "28772252-9c56-4e95-8b53-288c784efd57",
      "name": "High Season 2027",
      "start_month": 6,
      "start_day": 12,
      "end_month": 6,
      "end_day": 19,
      "product_name": "Bareboat",
      "discount_name": "35% discount",
      "price_per_day": 200.2,
      "valid_from_year": 2027,
      "valid_to_year": 2027,
      "discount_percentage": 35,
      "original_price_per_day": 308,
      "departs_from": { "id": 20810, "name": "Marina Zenta, Split", "city": "Split" },
      "departs_from_count": 1
    }
  ],
  "has_day_trips": false,
  "best_source": "mmk",
  "best_currency": "EUR",
  "price_currency": "EUR",
  "internal_discount_pct": null,
  "mmk_products": [
    { "name": "Bareboat", "isDefault": false },
    { "name": "Crewed", "isDefault": true }
  ]
}

{
  "price_per_day": 364,
  "original_price_per_day": 553,
  "discount_percentage": 45,
  "discount_label": "45% discount",
  "list_price": {
    "per_day": 364,
    "total": 2544,
    "original_per_day": 616,
    "discount_pct": 41,
    "from": true,
    "week": null,
    "week_start": null,
    "units": 7,
    "unit": "night",
    "party": 12,
    "label": "for 7 nights · all fees in"
  }
}

{
  "price_per_day": 307,
  "original_price_per_day": 553,
  "discount_percentage": 45,
  "discount_label": "45% discount",
  "best_price": 307,
  "lowest_price_per_day": 307
}

Note on the company block. The live response carries a company object. The documented API contract exposes only the currency, cancellation- and guest-terms fields shown above (base_currency, cancel_refund_days, cancel_refund_percent, terms_guest, terms_faq). Operator identity is not part of it — including the operator's id, which was removed from this response on 2026-09-15: a boat never names the company that runs it.

Images. images[].url and hero_image_url are un-resized masters (the example shortens their host). Don't hotlink them as returned: serve each image from https://media.charter.boats, keeping the path from /boats/… onward, and insert a size suffix before the extension — _card (400×300), _hero (1200×800) or _thumb (150×150), all WebP behind a .jpg filename. Masters can be pruned once the variants exist, so a bare path can 404 where a variant won't. (A URL whose path does not start /boats/ is not stored with us — typically an imported boat's source image.) images arrive in no particular order: sort by sort_order (and use is_primary for the cover).

Response Fields

Where each week departs from

Every row in prices carries the marina that week starts from:

A boat is not always in one place. Around 8% of the MMK fleet is quoted from more than one base across a year — some relocate seasonally, others are offered from several ports in the same week — so a week's departure marina is not always the marina on location.

Where departs_from_count is above 1, departs_from is null on purpose. We hold one quote for that week but cannot say which of the bases it belongs to, and naming one would be a guess. Show the count, or the boat's own marina, rather than picking.

One-way legs are still excluded. MMK also quotes delivery legs that start and end at different bases. Those are dropped from prices entirely: there is no single marina to name, and a booking attempt against one is rejected. Such a quote is often a fraction of the round-trip rate, so including it would make the boat look cheaper than anything you could book.

Skipper

rental_type: "skippered" means the charter comes with a skipper — it is not a statement that one can be arranged. A boat that is sold bareboat but also offers a crewed option reports rental_type: "bareboat", and the skipper shows as optional (skippered: "optional" on the list endpoint). When the operator makes the skipper an obligatory paid extra — the fee is marked required, so the guest cannot decline him — the boat counts as skippered for search purposes but reports skippered: "required": the boat cannot be sailed by the charterer, and the skipper's cost appears as a mandatory fee on top of the charter price rather than inside it. rental_type may still read "bareboat" on such boats.

⚠️ A crewed product and an obligatory skipper fee are not exclusive, and this is the case to get right: an operator can sell the boat as rental_type: "skippered" and bill "Skipper (+ food) — 160 EUR per day" as a required fee. The product class alone therefore cannot tell you whether the price covers him — skipper_charged can, and it is what the list endpoints report as skippered: "required" rather than true. Never present such a boat as "skipper included"; the skipper is obligatory and the guest pays for him on top.

The other way round is skipper_for_hire: a crewed product that bills no obligatory skipper but lists him as a priced optional extra (The Moorings' "Powered" cats: "Skipper - HR (subject to availability)", 280 a day) does not include him either. Such a boat reports skippered: "optional" and skipper_for_hire: true — unless the operator names a crew (crew non-null), in which case the priced row is a surcharge beside a crew that is aboard anyway and the boat stays true. The list endpoints derive the same fact from the same fee set, so a list row and its detail report one word.

We take this from the operator's own product setup rather than inferring it: whichever product they mark as the default is what the boat is, and a crewed product sitting alongside a bareboat default makes the skipper an add-on, not an inclusion.

A crewed charter is not always just a skipper, so the wording follows the source: the operator's product is named Crewed, and where they publish an actual roster we return it as crew — { "count": 4, "roles": ["Captain", "Chef", "Steward", "Deckhand"] }. Roles are reproduced as written, not mapped onto a vocabulary of ours, so expect free text and the occasional operator typo. crew is null on most crewed boats: a roster is published for a minority of them, and its absence says nothing about whether a crew is aboard — rental_type remains the answer to that.

Names, ages, photographs and biographies are deliberately not part of this response, though operators supply them.

Whether a licence is required is a separate question, and one we do not always know — it is absent from this response rather than guessed.

Company Object

Location Object

Errors

A listing that is not published — a draft, one an operator withdrew, or one belonging to a deactivated company — answers 404 exactly as a boat that never existed does, for every caller including your own boats. Read and edit your unpublished listings through the dashboard, not here.

When the boat you asked for — by either slug or UUID — has since been merged into another, the same hull listed twice and reconciled, the 404 carries the survivor so you can follow it instead of dropping the boat:

{
  "statusCode": 404,
  "message": "Boat not found",
  "data": { "moved_to": "bali-4-2-sunny" }
}

data.moved_to is a slug (or, for a survivor with no slug yet, a UUID) for this same endpoint. Treat it as a permanent move and update any stored id. It is absent — a plain 404 — when the boat never existed or when it was merged before this was recorded, so branch on its presence rather than assuming it.

A 404 for a listing that is no longer published may instead carry data.suggest: the search terms for the boat, never the boat. It is what you would type to look for one like it, and it is deliberately not a redirect — a hull withdrawn by one operator is often listed by another, but matching on a name asserts an identity we cannot prove (Merry Fisher is a model, so two different boats carry it).

It appears only for hulls listed through a booking partner, whose name, model and base that partner publishes itself. A listing an owner manages directly answers a bare 404 whether it exists or not, so suggest is never a way to test whether an unpublished listing is there.

{
  "statusCode": 404,
  "message": "Boat not found",
  "data": {
    "suggest": {
      "name": "Magnum Opus",
      "make_slug": "lagoon",
      "model_label": "50",
      "location_id": 4321,
      "location_name": "Marina Kaštela"
    }
  }
}

Every field is optional and any of them may be missing (a listing with no usable name carries no name; one with no manufacturer carries neither make_slug nor model_label; and a model label containing a comma is dropped, since that is the separator makes= uses). Feed them to GET /api/boats as q=<name>&makes=<make_slug>:<model_label>, falling back to makes=<make_slug>:<model_label>&location_id=<location_id> when that is empty. Nothing identifying is in it — no boat id, no operator, no price — and the response is still a 404, so do not treat it as a row.