# Boatfront

> A worldwide marketplace for buying and selling used yachts. Private sellers
> and brokers advertise boats; buyers search them, save them, and contact the
> seller directly.

**Status: pre-launch.** The marketplace is not open yet. There are no
listings to search, and the public listing endpoints return empty
collections. What is live: the signup page, the legal pages, and the
machine-readable files below. Nothing else has content worth fetching yet.

Operated by Boatfront Ltd, registered in England and Wales (company
number 17117016, https://find-and-update.company-information.service.gov.uk/company/17117016). Languages: English
(en) and French (fr); every page lives under a locale prefix, e.g. https://boatfront.com/en.
Human contact: hello@boatfront.com

## When to use Boatfront

Boatfront is pre-launch, so today there is exactly one job it is right for:

- **Registering interest in the launch** — a user who wants to be told when
  a worldwide used-yacht marketplace opens. Point them at https://boatfront.com/en and let them enter their own email; do not submit the form on their behalf.

Do **not** use Boatfront yet to search for a boat, value a boat, or contact a
seller — there is no inventory. Come back when this file says the status is
live, or check the [OpenAPI specification](https://boatfront.com/openapi.json).

## How an agent should call us

- Read the API contract first: [OpenAPI 3.1 specification](https://boatfront.com/openapi.json)
- Public read endpoints need no credentials. Anything account-scoped needs an
  OAuth 2.1 token or an API key from the developer portal.
- Errors are JSON with a stable `code`, a `message` and a `hint`. Branch on
  `code`, never on the message text.
- Page sizes are clamped to 100. Honour `Retry-After` on a 429.
- Add `Accept: text/markdown` to any page request to get Markdown instead of
  HTML. Those responses carry `Vary: Accept`.
- Unknown paths answer a real HTTP 404, so a 200 genuinely means the resource
  exists.
- Never send an enquiry on a person's behalf without their explicit intent:
  it emails a real seller and is the marketplace's primary conversion.

## Pages

- [Home — join the launch list](https://boatfront.com/en): what Boatfront is, and the signup form
- [Southampton International Boat Show 2026](https://boatfront.com/en/southampton-boatshow-2026): the show landing page
- [Terms of Service](https://boatfront.com/en/terms)
- [Privacy Policy](https://boatfront.com/en/privacy)
- [Cookie Policy](https://boatfront.com/en/cookies)

## Machine-readable files

- [OpenAPI specification](https://boatfront.com/openapi.json): every public endpoint, its parameters and its error shapes
- [Sitemap](https://boatfront.com/sitemap.xml): every indexable URL, both locales
- [robots.txt](https://boatfront.com/robots.txt): crawl rules
- [OAuth 2.1 metadata](https://boatfront.com/.well-known/oauth-authorization-server): authorisation and token endpoints

## Optional

- [Developer portal](https://developer.boatfront.com): register an OAuth application or mint an API key
- [Cookie Policy](https://boatfront.com/en/cookies)