API documentation
Query published yacht models, builders, places and market records through REST or MCP. Explore the response for your language before integrating.
Resources
- Yacht models
GET /api/v1/models- Builders
GET /api/v1/builders- Marinas
GET /api/v1/marinas- Onboard equipment
GET /api/v1/equipment- Marketplace
GET /api/v1/listings- Guides
GET /api/v1/knowledge- Charter departures
GET /api/v1/departures- Service providers
GET /api/v1/providers- Licensed media
GET /api/v1/media
curl -sS 'https://yachtluma.ai/api/v1/models/lagoon-42?locale=en'
curl -sS 'https://yachtluma.ai/api/v1/compare?models=lagoon-42,lagoon-46&locale=en'Pagination and filters
List requests accept limit from 1 to 100 and offset from 0. Send nextOffset as the next offset until it is null. Filter models by builder or type and listings by category.
curl -sS 'https://yachtluma.ai/api/v1/models?q=Lagoon&locale=en&limit=2&offset=0'
curl -sS 'https://yachtluma.ai/api/v1/listings?category=charter&locale=en&limit=5'
curl -sS 'https://yachtluma.ai/api/v1/departures?mode=seat&guests=2&location=Palma&limit=5'
curl -sS 'https://yachtluma.ai/api/v1/providers?service=maintenance&limit=5'
curl -sS 'https://yachtluma.ai/api/v1/media?entityType=model&entityId=lagoon-46&locale=en'Field availability
Web, API and AI distribution follow the source permissions for each specification. A model may have an empty specifications array. Keep the status, unit, date and configuration when presenting a value.
specifications_status · available / not_available_for_this_channelApplications and quotas
Anonymous traffic shares 10,000 requests per UTC day. Approved applications have an individual daily quota and access only their approved channels and resources. Send the application key in the Authorization header.
Authorization: Bearer <APPLICATION_KEY>My applicationsMCP
Connect an MCP client to the endpoint using Streamable HTTP. Run initialize, then tools/list for the current tool schemas. Calls read published records.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_models",
"arguments": {
"q": "Lagoon",
"locale": "en",
"limit": 3
}
}
}search_modelssearch_builderssearch_listingsfind_marinassearch_equipmentsearch_knowledgeget_modelget_listingget_equipmentget_care_guidecompare_modelssearch_yacht_pagesget_market_countssearch_departuresget_departuresearch_providersget_providersearch_mediaget_mediaestimate_charter_budget