{"openapi":"3.1.0","info":{"title":"Islands & Sails — BVI Charter API","version":"1.0.0","description":"Public API for the Islands & Sails BVI crewed catamaran charter fleet. All rates are in USD per week and are all-inclusive — captain, chef, crew, food, and drinks are covered. A 15–20% crew gratuity is customary.","contact":{"name":"Islands & Sails","url":"https://www.bvicrewed.com","email":"hello@bvicrewed.com"}},"servers":[{"url":"https://www.bvicrewed.com","description":"Production"}],"paths":{"/api/yachts":{"get":{"operationId":"listYachts","summary":"List available BVI charter yachts","description":"Returns the full Islands & Sails fleet of crewed catamarans. Optionally filter by max weekly rate, minimum cabins, guest count, activity, or use-case tag.","parameters":[{"name":"maxRate","in":"query","description":"Maximum weekly charter rate in USD (e.g. 25000)","schema":{"type":"integer"}},{"name":"minCabins","in":"query","description":"Minimum number of cabins required","schema":{"type":"integer"}},{"name":"guests","in":"query","description":"Number of guests (returns yachts where guests >= this value)","schema":{"type":"integer"}},{"name":"activity","in":"query","description":"Activity tag to filter by (e.g. e-foiling, fishing, sailing, snorkeling, water-skiing, sea-scooters, stargazing)","schema":{"type":"string"}},{"name":"bestFor","in":"query","description":"Use-case tag (e.g. couples, families, food, adventure, romance, value, sailing, luxury, large-groups)","schema":{"type":"string"}}],"responses":{"200":{"description":"Array of matching yachts with full details","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"yachts":{"type":"array","items":{"$ref":"#/components/schemas/Yacht"}},"pricingNote":{"type":"string"}}}}}}}}},"/api/yachts/{id}":{"get":{"operationId":"getYacht","summary":"Get a single yacht by ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Yacht ID (e.g. dream-on, reverie, samana)"}],"responses":{"200":{"description":"Yacht details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Yacht"}}}},"404":{"description":"Yacht not found"}}}}},"components":{"schemas":{"Yacht":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"model":{"type":"string"},"built":{"type":"integer"},"url":{"type":"string","description":"Direct link to full yacht profile"},"tagline":{"type":"string"},"conciergeNote":{"type":"string","description":"Personal recommendation from the Islands & Sails concierge"},"cabins":{"type":"integer"},"guests":{"type":"integer","description":"Maximum guest capacity"},"weeklyRateUSD":{"type":"integer","description":"Weekly charter rate in USD, crew included"},"features":{"type":"array","items":{"type":"string"}},"activities":{"type":"array","items":{"type":"string"}},"amenities":{"type":"array","items":{"type":"string"}},"bestFor":{"type":"array","items":{"type":"string"},"description":"Use-case tags for matching guest preferences"},"awards":{"type":"array","items":{"type":"string"}},"menuHighlight":{"type":"string","description":"Chef signature dishes"},"status":{"type":"string","enum":["Available your dates","Checking availability...","In high demand"]},"note":{"type":"string","description":"Pricing disclaimer about gratuity and provisioning"}}}}}}