Build on the 12 Seas Alliance 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.

๐Ÿ“˜ API Reference

Every endpoint, schema and example โ€” generated straight from the code, so it is never out of date. Open the docs โ†’

๐Ÿงช Playground

Try real requests from your browser with your sk_test_ key against demo data. Open the playground โ†’

๐Ÿ”‘ API Keys

Keys are created by your team in the Operator Portal under Settings โ†’ API. Your company admin controls who may hold one.

Getting started

  1. 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. Keys are world-bound: sk_test_ works on the demo & staging hosts, sk_live_ only on production. Send it in the x-api-key header โ€” never in a URL.
  3. Make your first call:
    curl https://demo-openapi.12seasalliance.com/v1/boats \
      -H "x-api-key: sk_test_..."
  4. Notes: all money fields carry an explicit currency (IDR); all dates are local calendar dates (YYYY-MM-DD, no timezone โ€” don't parse them as UTC); list endpoints paginate with cursor / next_cursor.
  5. Go live: swap the host to openapi.12seasalliance.com and the key to sk_live_. Nothing else changes.