Loading...
Loading...
Integrate the world's most comprehensive luxury yacht charter platform into your product. A developer experience built for speed, reliability, and scale.
$ curl https://api.yh-charter.com/v1/yachts
-H "Authorization: Bearer sk_test_EXAMPLE_0000..."
-H "Content-Type: application/json"
# Response — 200 OK
{
"object": "list",
"data": [...48 yachts]
}Platform
Predictable resource-oriented URLs, JSON-encoded responses, and standard HTTP verbs. Idempotency keys supported on every write.
Subscribe to 40+ event types across bookings, payments, and fleet status. Automatic retries with exponential backoff.
Type-safe, hand-crafted libraries for Node.js, Python, Ruby, and PHP. Maintained by our core team with weekly releases.
mTLS, signed requests, per-endpoint scopes, and rotating API keys. SOC 2 Type II, PCI-DSS, and GDPR compliant.
Quickstart
Our onboarding is designed so that your first successful API call happens in under five minutes. No sales calls, no paperwork.
Create a free developer account in under 60 seconds. No credit card required for the sandbox tier.
Generate a publishable and secret key pair from your developer dashboard. Test and live keys are provided.
Fetch the global yacht fleet with a single GET request. Our quickstart example gets you integrated in minutes.
Code Examples
curl https://api.yh-charter.com/v1/yachts \
-H "Authorization: Bearer sk_test_EXAMPLE_0000_not_a_real_key" \
-H "Content-Type: application/json" \
-d '{"destination":"amalfi-coast","guests":10,"check_in":"2026-07-14"}'curl https://api.yh-charter.com/v1/yachts \
-H "Authorization: Bearer sk_test_EXAMPLE_0000_not_a_real_key" \
-H "Content-Type: application/json" \
-d '{"destination":"amalfi-coast","guests":10,"check_in":"2026-07-14"}'import { YHCharter } from '@yh-charter/node';
const client = new YHCharter({
apiKey: process.env.YH_CHARTER_API_KEY, // sk_test_EXAMPLE_0000... (fake)
});
const yachts = await client.yachts.search({
destination: 'amalfi-coast',
guests: 10,
checkIn: '2026-07-14',
});import { YHCharter } from '@yh-charter/node';
const client = new YHCharter({
apiKey: process.env.YH_CHARTER_API_KEY, // sk_test_EXAMPLE_0000...
});
const yachts = await client.yachts.search({
destination: 'amalfi-coast',
guests: 10,
checkIn: '2026-07-14',
});
console.log(`Found ${yachts.data.length} available yachts`);{
"object": "list",
"has_more": false,
"data": [
{
"id": "yacht_EXAMPLE_ionian_spirit",
"name": "Ionian Spirit",
"length_m": 48,
"guests_max": 12,
"day_rate_eur": 18500,
"currency": "EUR"
}
]
}{
"object": "list",
"has_more": false,
"data": [
{
"id": "yacht_EXAMPLE_ionian_spirit",
"object": "yacht",
"name": "Ionian Spirit",
"length_m": 48,
"guests_max": 12,
"cabins": 6,
"crew": 9,
"home_port": "Naples, IT",
"day_rate_eur": 18500,
"currency": "EUR"
}
]
}Featured endpoints
List, filter, and retrieve detailed yacht specifications, cabin layouts, media galleries, and crew.
GET /v1/yachtsGET /v1/yachts/:idGET /v1/yachts/:id/availabilityCreate, modify, confirm, and cancel bookings. Support for partial payments, deposits, and itineraries.
POST /v1/bookingsGET /v1/bookings/:idPATCH /v1/bookings/:idReal-time availability checks across the fleet. Supports date ranges, location filters, and instant booking.
GET /v1/availabilityPOST /v1/availability/searchGET /v1/availability/calendarManage guest profiles, preferences, passports, dietary requirements, and loyalty program membership.
POST /v1/guestsGET /v1/guests/:idPATCH /v1/guests/:idGenerate instant, personalised quotes with dynamic pricing, add-ons, crew gratuity, and tax breakdown.
POST /v1/quotesGET /v1/quotes/:idPOST /v1/quotes/:id/acceptOfficial SDKs
Type-safe, fully documented, and maintained by the YH Charter team. Install via your favourite package manager and start in seconds.
Rate limits & pricing
All tiers include: encryption in transit & at rest, signed webhooks, request logs, and the full endpoint catalogue.
Join 3,200+ developers shipping yacht booking experiences around the world.