12seasalliance Developers

Partner API · v1

Documentation for the 12seasalliance Partner API

Read your fleet, cabins, availability and bookings over a clean REST API. Explore in the demo world first — then go live with your production key.

Read the docsOpen the playground

Product 1 · Partner API

Hit the API from your systems

Server-to-server, authenticated with an x-api-key. Read your fleet, availability and bookings as JSON.

API docs Playground

Product 2 · Embed widget

Embed availability on your website

A 2 KB snippet shows live departures, prices and a WhatsApp button. No key in the browser — authorized per website.

Embed guide Embed API

Explore

Partner API

API ReferenceEvery endpoint, schema and example — generated from the code, never out of date.PlaygroundSend real requests from the browser against demo data with an sk_test_ key.Pricing v2 (preview)Operator price sheets, periods, trips and a per-guest batch quote — read + quote, staging first.AuthenticationWorld-bound keys: sk_test_ for demo & staging, sk_live_ for production. x-api-key header.Pagination & conventionscursor / next_cursor pagination, explicit currency on money, local calendar dates.

Embed widget

How to embed — 3 stepsCreate a widget, paste a 2 KB snippet, wire consent. No API key ever touches the browser.→Embed API referenceThe widget's public JSON surface, for headless builds: config, availability, render.→

Getting started

1
Get a key. Ask your company admin to enable API access, then create a key in the Operator Portal → Settings → API. The key is shown once — store it safely.
2
Call the demo world. sk_test_ works on demo-openapi.12seasalliance.com — real gate, demo data, impossible to touch production.
3
Go live. Swap the host to openapi.12seasalliance.com and the key to sk_live_. Nothing else changes.