{
  "openapi": "3.0.3",
  "info": {
    "title": "Private Yacht Thailand API",
    "description": "Read-only API for private yacht charter listings in Thailand.\nSearch, yacht details and configured quotes identify charter_product: exclusive use of the entire yacht with captain and crew, not a shared-tour ticket.\nSearch price.basis and quote price_basis state per-private-charter pricing, the base guest allowance and requested group size. Do not multiply the group amount by guest count.\nCovers Phuket, Krabi, Koh Samui and surrounding islands.\nProvides yacht details, calendar-backed availability, seasonal pricing, and trip destinations.\nAvailability assurances end today plus three calendar months inclusive (Asia/Bangkok, month-end clamped).\nLater dates are on_request; known bookings remain blocked. Applies to search, alternatives, range and quote.\nPrices remain calculable beyond that cutoff. availability_policy.available_through gives the current cutoff.\nYacht details include guide_languages with published yacht-specific guide languages, source and scope.\nYacht details include terms with sourced general sections, yacht-specific conditions and the standard balance setting. Preserve exceptions; this is not a refund calculator or booking confirmation.\nMenu descriptions preserve HTML line breaks as plain text; menu names and prices stay unchanged.\nYacht details and quotes include child_pricing with the yacht-specific strictly-under age threshold, extra-passenger billing mode, same menu price for adults/children and drinks add-ons charged to the adult count only. Day-trip search with children requires calculate_quote for a price; overnight comparison prices already include adult/child surcharges.\nSearch tour.duration_hours and quote duration_hours carry the selected tour's published duration; yacht detail trips already expose duration_hours. Null means no positive duration is recorded. Use duration for selection and offers; never infer departure/return times or delay a quote solely for a missing start time.\nOvernight details and quotes expose duration_days, duration_nights, duration_label, duration_kind and published_time_text. Standard overnight categories use their published days/nights, with duration_hours null. Special overnight categories retain their published category label; internal tripdays codes 8/9 are not day counts. Published times are verbatim, without default times. Do not convert days to hours. Fleet search supports standard overnight tours with trip_type=overnight and required charter_days=2..7. Every occupied calendar day including the final day is checked. One blocked day excludes the yacht; incomplete or beyond-three-month coverage means on_request. Capacity uses the selected overnight tour allowance. Comparison prices cover the entire tour and adult/child surcharges, excluding selected extras, payment fees and park cash; use calculate_quote for a configured quote. Adjacent-date alternatives shift the entire interval. Special night/24-hour categories are not in overnight fleet search.\nCalculated quotes include trip_context with start_date, end_date and published_meals filtered to the selected tour type. Preserve meal status and conditions; confirmed overnight all-meals inclusions need no staff reconfirmation. Missing meal listings do not establish exclusion. selected_option_conditions also retains selected add-on and transfer source details. Dates do not imply fixed boarding or return times.\nQuote trip_context.departure identifies the published pier for the selected tour region, using the same primary/secondary location pairs as the website. A missing matching pier stays null with status not_listed; never substitute the primary pier from another region. Published departure does not specify boarding or pickup time. The inquiry draft includes the departure pier/region.\nMulti-day park fees require the final itinerary: several parks or islands may charge separately. park_cash.calculation_status=itinerary_required; total_thb, adult_total_thb and children_total_thb remain null. reference_fees retain individual published tariffs only. Never use the maximum single tariff or multiply it by days as a cruise total. Included park fees remain zero additional cost.\nChild park fees are estimated at 50% of the highest listed adult park fee for the selected tour (operator policy). Included park fees remain zero; missing adult fees remain null. park_cash exposes per_child_thb, children_total_thb, total_thb, calculation_status and fee_disclaimer. Park age policy: under 3 free; ages 3 through 13 pay 50%; ages 14 and over pay the adult fee. Supply child_ages to calculate park totals independently of yacht child-age thresholds. Without ages, park totals for parties with children remain unknown. Fees may change without prior notice; the amount charged at the park applies. Fees may change without prior notice; the amount charged at the park applies. Keep park cash separate from charter payment and payment-provider fees.\nOptional aircon exposes priced_options in yacht details and requested_features.aircon in search, including exact quote_parameter/quote_value, listed amount, calculator billing basis and any named usage duration. These charges are additional to search comparison prices.\nYachts currently not offered are excluded from search, alternatives, yacht lists, pricing, destinations and calendar ranges for every requested date. Direct details return offer_status=not_offered without sale details, and quotes are rejected. Older listings do not override this status.\nSearch offers, yacht details and quotes include inquiry with a draft WhatsApp link and full message using the existing website contact. Scope distinguishes yacht-only, date/guests and selected configuration. Nothing is sent, reserved or booked. website_url opens the calculator without prefilled values; long messages may require copy/paste (message_in_url=false).\ninquiry.request_code is a PY-AI-prefixed draft origin marker appended to the message; it is not a stored inquiry, retrievable quote, verified agent identity or booking ID.\nAll prices in Thai Baht (THB). No authentication required.\n",
    "version": "1.2",
    "contact": {
      "email": "email@deepbluecharter.com"
    }
  },
  "servers": [
    {
      "url": "https://api.private-yacht.com",
      "description": "Production"
    }
  ],
  "paths": {
    "/offers": {
      "get": {
        "operationId": "findYachtOffers",
        "summary": "Configure group offers with equipment, meals and hotel transfers in one request",
        "description": "Requires actual child ages when children travel. Reuses the website calculator. Complete offers, feature alternatives and incomplete configurations are separate. A named lowest eligible menu is proposed if meals are not already included. Park cash remains separate. Only the requested date is checked. All matching tours are retained. Up to 3 tour candidates per group (maximum 6 quotes per page); follow next_offset. Different yachts are interleaved within availability status. This is not an exhaustive fleet-wide cheapest-price ranking. No booking or payment.",
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": true,
            "description": "YYYY-MM-DD, tomorrow onward in Asia/Bangkok; up to 365 days after tomorrow.",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "adults",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000
            }
          },
          {
            "name": "children",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000
            }
          },
          {
            "name": "region",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "all",
                "phuket",
                "krabi",
                "samui",
                "pattaya"
              ]
            }
          },
          {
            "name": "trip_type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "fullday",
                "halfday",
                "overnight"
              ]
            }
          },
          {
            "name": "charter_days",
            "in": "query",
            "required": false,
            "description": "Required for overnight: total days (2-7), nights = days minus one. Entire interval is checked. Omit for day trips.",
            "schema": {
              "type": "integer",
              "minimum": 2,
              "maximum": 7
            }
          },
          {
            "name": "features",
            "in": "query",
            "required": false,
            "description": "Comma-separated water_slide, floating_pool, private_chef, aircon. Synonyms include slider, Rutsche, AC and Klimaanlage. Aircon scope may be Full, cabins only or optional; preserve these distinctions.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "feature_mode",
            "in": "query",
            "required": false,
            "description": "preferred returns separated alternatives missing requested features; required excludes them.",
            "schema": {
              "type": "string",
              "enum": [
                "preferred",
                "required"
              ]
            }
          },
          {
            "name": "yacht_type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "catamaran",
                "sailing_yacht",
                "superyacht",
                "sailing_monohull",
                "motor_yacht",
                "power_catamaran",
                "speedboat",
                "large_group_boat",
                "sailing_catamaran",
                "luxury_speedboat"
              ]
            }
          },
          {
            "name": "destination",
            "in": "query",
            "required": false,
            "description": "Published destination name or unambiguous published alias, case-insensitive; e.g. Coral Island, Banana Beach or Koh Hey. No substring matching; ambiguous aliases require the full destination name.",
            "schema": {
              "type": "string",
              "maxLength": 150
            }
          },
          {
            "name": "max_price_thb",
            "in": "query",
            "required": false,
            "description": "Maximum configured charter payment, including selected extras and payment fee; separate park cash excluded. Applied after calculation.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100000000
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "1-3 tour candidates per group; default 3. Offset counts tours. Follow next_offset even when a page has incomplete or over-budget candidates.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 3
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000
            }
          },
          {
            "name": "yacht_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "child_ages[]",
            "in": "query",
            "required": false,
            "description": "Actual ages in completed years of every child/teen in the party, including infants. When supplied, adults excludes all guests in this list; children, if supplied, must equal its length. Do not preclassify by yacht age. The server derives charter and park categories separately.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "maxItems": 1000,
              "items": {
                "type": "integer",
                "minimum": 0,
                "maximum": 17
              }
            }
          },
          {
            "name": "payment_method",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "cash_thb",
                "bank_transfer_thb",
                "wise_thb",
                "revolut_thb",
                "credit_card",
                "paypal_stripe",
                "wechat",
                "alipay"
              ]
            }
          },
          {
            "name": "meal",
            "in": "query",
            "required": false,
            "description": "Default none. Use published inclusions first. For lunch, propose the lowest listed eligible menu and name it explicitly. Missing/ambiguous coverage remains incomplete. all_meals requires overnight.",
            "schema": {
              "type": "string",
              "enum": [
                "none",
                "lunch",
                "all_meals"
              ]
            }
          },
          {
            "name": "pickup_area",
            "in": "query",
            "required": false,
            "description": "Published pickup zone or one exact locality in it, e.g. Patong. Unique match at the tour departure region required; roundtrip transfer for the entire group is included in the quote.",
            "schema": {
              "type": "string",
              "maxLength": 150
            }
          },
          {
            "name": "tours_per_yacht",
            "in": "query",
            "required": false,
            "description": "Interleave 1 or 2 tours per yacht before moving to the next yacht. All eligible tours remain reachable through pagination; no fleet-wide cheapest-price claim.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Configured offers, stated differences, incomplete configurations and pagination",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input or missing actual child ages"
          },
          "429": {
            "description": "Rate limit; respect Retry-After"
          },
          "503": {
            "description": "Temporary data or capacity failure; no price or availability inferred"
          }
        }
      }
    },
    "/quote": {
      "get": {
        "operationId": "calculateQuote",
        "summary": "Calculate a selected yacht tour configuration without booking",
        "description": "Returns charter payment and separate park cash. Use exact option names from yacht details. No booking, payment or inquiry is made. Prices follow yacht-mode website calculator, including children, selected extras and rounding. THB settlement; full payment conditions apply.",
        "parameters": [
          {
            "name": "child_ages[]",
            "in": "query",
            "description": "Actual ages in completed years of every child/teen in the party, including infants. When supplied, adults excludes all guests in this list; children, if supplied, must equal its length. Do not preclassify by yacht age. The server derives charter and park categories separately.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "maxItems": 1000,
              "items": {
                "type": "integer",
                "minimum": 0,
                "maximum": 17
              }
            }
          },
          {
            "name": "yacht_id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "trip_id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "date",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "adults",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000
            }
          },
          {
            "name": "children",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000
            }
          },
          {
            "name": "food",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 150
            },
            "description": "Exact menu name from yacht details; omit if not selected."
          },
          {
            "name": "transfer",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 150
            },
            "description": "Exact pickup area from transfers.options; selected tour determines pier."
          },
          {
            "name": "addons[]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "maxItems": 20,
              "uniqueItems": true,
              "items": {
                "type": "string",
                "maxLength": 150
              }
            },
            "style": "form",
            "explode": true,
            "description": "Exact names from options with category addon."
          },
          {
            "name": "addons_pp[]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "maxItems": 20,
              "uniqueItems": true,
              "items": {
                "type": "string",
                "maxLength": 150
              }
            },
            "style": "form",
            "explode": true,
            "description": "Exact names from options with category addonpp."
          },
          {
            "name": "drinks[]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "maxItems": 10,
              "uniqueItems": true,
              "items": {
                "type": "string",
                "maxLength": 150
              }
            },
            "style": "form",
            "explode": true,
            "description": "Exact names from drinks.options; select only explicitly requested options."
          },
          {
            "name": "payment_method",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "cash_thb",
                "bank_transfer_thb",
                "wise_thb",
                "revolut_thb",
                "credit_card",
                "paypal_stripe",
                "wechat",
                "alipay"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Itemized selected configuration, payment conditions and date availability; park cash is separate",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Invalid selection, capacity, missing source price or blocked date"
          },
          "429": {
            "description": "Rate limit; respect Retry-After"
          },
          "503": {
            "description": "Temporary capacity or data failure; respect Retry-After when provided"
          }
        }
      }
    },
    "/mcp": {
      "post": {
        "operationId": "mcpRequest",
        "summary": "Remote MCP endpoint for public read-only yacht tools",
        "description": "Stateless MCP Streamable HTTP, JSON response mode. Tools are find_yacht_offers, search_yachts,\nget_yacht_details and calculate_quote. Uses the same services as the REST API. No authentication\nrequired for public data. Negotiate initialize, then notifications/initialized.\nSupported versions are 2025-11-25, 2025-06-18 and 2025-03-26. Server-side clients\nare supported; existing REST browser CORS policy is unchanged. GET returns 405\nbecause no standalone SSE stream is offered. No booking or payment actions.\n",
        "parameters": [
          {
            "name": "MCP-Protocol-Version",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "2025-11-25",
                "2025-06-18",
                "2025-03-26"
              ]
            },
            "description": "Negotiated version on requests after initialization."
          },
          {
            "name": "Accept",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "example": "application/json, text/event-stream"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "jsonrpc"
                ],
                "properties": {
                  "jsonrpc": {
                    "type": "string",
                    "enum": [
                      "2.0"
                    ]
                  },
                  "id": {
                    "oneOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "string"
                      }
                    ]
                  },
                  "method": {
                    "type": "string"
                  },
                  "params": {
                    "type": "object"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "429": {
            "description": "Request limit reached. Honor Retry-After before retrying."
          },
          "200": {
            "description": "JSON-RPC result or error; tool failures have result.isError=true.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "202": {
            "description": "Notification accepted with no response body."
          },
          "400": {
            "description": "Invalid JSON-RPC message or unsupported version header."
          },
          "403": {
            "description": "Origin is not permitted."
          },
          "406": {
            "description": "Required Accept media types missing."
          },
          "413": {
            "description": "Request exceeds 64 KiB."
          },
          "415": {
            "description": "Content-Type must be application/json."
          }
        }
      }
    },
    "/search": {
      "get": {
        "operationId": "searchYachts",
        "summary": "Compare yachts for a date and guest count",
        "description": "Uses Booka QuickQuote pricing and cached calendar checks. Returns published\nyachts with matching day or standard overnight tours and comparison prices, not all-in quotes.\nAvailable means a fresh calendar check, never a reservation. Otherwise\navailability is on_request, with a separate technical reason. Booked yachts\nare omitted. Children count toward capacity. Overnight comparisons include child surcharges; day-trip child totals require calculate_quote.\nDestination matches are exact, case-insensitive names from the tour data.\nUp to three matching tour options per yacht are returned.\nOptional yacht_id selects one yacht. flex_days=1 checks the previous and next\nday only when no matching yacht is available on the requested date, across\nall pages. Defaults to 1 for a targeted yacht, otherwise 0. Alternative dates\nare separate suggestions with fresh availability and independently calculated\nprices; they never change the requested date. Same-day/past and out-of-range\nalternatives are skipped. A failed alternative check does not discard the main result.\n",
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": true,
            "description": "From tomorrow through the following 365 days, Asia/Bangkok.",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "adults",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000
            }
          },
          {
            "name": "children",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000,
              "default": 0
            }
          },
          {
            "name": "region",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "all",
                "phuket",
                "krabi",
                "samui",
                "pattaya"
              ],
              "default": "all"
            }
          },
          {
            "name": "trip_type",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "fullday",
                "halfday",
                "overnight"
              ],
              "default": "fullday"
            }
          },
          {
            "name": "charter_days",
            "in": "query",
            "description": "Required for overnight searches, omit for day trips. Total days; nights equals days minus one.",
            "schema": {
              "type": "integer",
              "minimum": 2,
              "maximum": 7
            }
          },
          {
            "name": "yacht_id",
            "in": "query",
            "description": "Restrict both requested and alternative dates to this yacht.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "flex_days",
            "in": "query",
            "description": "Check +/-1 day if no matching fresh availability. Default: 1 with yacht_id, otherwise 0. Set 0 to disable.",
            "schema": {
              "type": "integer",
              "enum": [
                0,
                1
              ]
            }
          },
          {
            "name": "features",
            "in": "query",
            "description": "Comma-separated water_slide, floating_pool, private_chef, aircon. Synonyms include slider, Rutsche and inflatable pool. All requested features must match.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "feature_mode",
            "in": "query",
            "description": "preferred returns separate alternatives with differences; required excludes missing, on-request or tour-ineligible features. Priced optional extras count as matches, with charges stated.",
            "schema": {
              "type": "string",
              "enum": [
                "preferred",
                "required"
              ],
              "default": "preferred"
            }
          },
          {
            "name": "yacht_type",
            "in": "query",
            "description": "Mandatory type filter. catamaran includes power and sailing catamarans; sailing_yacht includes sailing monohulls and sailing catamarans.",
            "schema": {
              "type": "string",
              "enum": [
                "catamaran",
                "sailing_yacht",
                "superyacht",
                "sailing_monohull",
                "motor_yacht",
                "power_catamaran",
                "speedboat",
                "large_group_boat",
                "sailing_catamaran",
                "luxury_speedboat"
              ]
            }
          },
          {
            "name": "destination",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 150
            }
          },
          {
            "name": "max_price_thb",
            "in": "query",
            "description": "Comparison-price cap only; offers without a calculated price are omitted.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100000000
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 30,
              "default": 10
            }
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            }
          }
        ],
        "responses": {
          "429": {
            "description": "Request limit reached. Honor Retry-After before retrying."
          },
          "200": {
            "description": "Matching yachts ordered by availability and comparison price.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FleetSearchResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameters; overnight requires charter_days from 2 through 7."
          },
          "503": {
            "description": "Data unavailable; no availability inferred."
          }
        }
      }
    },
    "/yachts": {
      "get": {
        "operationId": "listYachts",
        "summary": "List published yachts",
        "description": "Returns published yachts with public details, departure regions and tour destinations. Use search or quote for prices.",
        "parameters": [
          {
            "name": "region",
            "in": "query",
            "required": false,
            "description": "Filter by departure region (phuket, krabi, samui, pattaya) or exact trip-destination name. Case-insensitive; primary and secondary departure regions both match.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of yachts",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "yachts": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/YachtSummary"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/yachts/{id}": {
      "get": {
        "operationId": "getYacht",
        "summary": "Get yacht detail",
        "description": "Yacht detail with published facts, scoped inclusions, add-ons, coverage limitations and next action. Unlisted searchable equipment is not available; preserve explicit conditions.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Yacht ID",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "429": {
            "description": "Request limit reached. Honor Retry-After before retrying."
          },
          "200": {
            "description": "Yacht detail",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/YachtDetail"
                }
              }
            }
          },
          "404": {
            "description": "Yacht not found"
          }
        }
      }
    },
    "/availability": {
      "get": {
        "operationId": "getAvailability",
        "summary": "Check yacht availability",
        "description": "Returns explicit available, booked and on_request date arrays for every published yacht, using the same helper as search and quote. Reads cached provider data and active local bookings, without live provider fetches. Missing/stale/incomplete data is on_request.\nEach date belongs to exactly one status. checked_at is the oldest observed mapped calendar update in the range, not coverage proof; generated is response creation time. Available is not a reservation.\nMaximum 90 inclusive dates; both dates must be tomorrow through tomorrow + 365 days. Shared 20-second response cache and request/concurrency limits apply.\n",
        "parameters": [
          {
            "name": "start_date",
            "in": "query",
            "required": false,
            "description": "Start date (YYYY-MM-DD). Defaults to tomorrow (Asia/Bangkok).",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "end_date",
            "in": "query",
            "required": false,
            "description": "End date (YYYY-MM-DD). Defaults to start_date + 89 days.",
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "400": {
            "description": "Invalid parameters or date range"
          },
          "429": {
            "description": "Rate limit; honor Retry-After"
          },
          "503": {
            "description": "Temporarily unavailable; no availability inferred"
          },
          "200": {
            "description": "Availability data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AvailabilityResponse"
                }
              }
            }
          }
        }
      }
    },
    "/pricing": {
      "get": {
        "operationId": "getPricing",
        "summary": "Get seasonal pricing",
        "description": "Returns pricing for all yachts on a specific date. Prices vary by season\n(peak, regular, low). Shows the cheapest trip per type (fullday, halfday, overnight).\n",
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": false,
            "description": "Date to get pricing for (YYYY-MM-DD). Defaults to today.",
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Pricing data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PricingResponse"
                }
              }
            }
          }
        }
      }
    },
    "/destinations": {
      "get": {
        "operationId": "listDestinations",
        "summary": "List destinations",
        "description": "Returns unique trip destinations with yacht counts and minimum prices.",
        "responses": {
          "200": {
            "description": "List of destinations",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "destinations": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Destination"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "YachtSummary": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string",
            "description": "Yacht name with brand and length, e.g. 'Bahia (Azimut 52ft)'"
          },
          "brand": {
            "type": "string"
          },
          "length_ft": {
            "type": "integer"
          },
          "max_passengers": {
            "type": "integer"
          },
          "regions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Trip destinations this yacht serves"
          },
          "departure_regions": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "Phuket",
                "Krabi",
                "Samui",
                "Pattaya"
              ]
            },
            "description": "Published primary and secondary departure areas. Legacy regions lists tour destinations."
          },
          "cover_image": {
            "type": "string",
            "format": "uri",
            "nullable": true
          },
          "min_price_thb": {
            "type": "integer",
            "nullable": true,
            "description": "Null for legacy metadata. Use search or quote for verified public customer prices."
          },
          "availability_mode": {
            "type": "string",
            "enum": [
              "calendar",
              "on_request"
            ],
            "description": "Tracking capability only, not date-specific availability."
          },
          "trip_count": {
            "type": "integer"
          }
        }
      },
      "YachtDetail": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "brand": {
            "type": "string"
          },
          "length_ft": {
            "type": "integer"
          },
          "max_passengers": {
            "type": "integer"
          },
          "regions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "departure_regions": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "Phuket",
                "Krabi",
                "Samui",
                "Pattaya"
              ]
            },
            "description": "Published primary and secondary departure areas. Legacy regions lists tour destinations."
          },
          "cover_image": {
            "type": "string",
            "format": "uri",
            "nullable": true
          },
          "gallery": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uri"
            }
          },
          "departure_piers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "availability_mode": {
            "type": "string",
            "enum": [
              "calendar",
              "on_request"
            ]
          },
          "source_url": {
            "type": "string",
            "format": "uri"
          },
          "facts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "text": {
                  "type": "string"
                },
                "group": {
                  "type": "string"
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "included",
                    "included_with_scope",
                    "conditional"
                  ]
                },
                "applies_to": {
                  "type": "string",
                  "enum": [
                    "fullday",
                    "as_stated"
                  ]
                },
                "requires_reconfirmation": {
                  "type": "boolean"
                },
                "source_url": {
                  "type": "string",
                  "format": "uri"
                }
              }
            }
          },
          "options": {
            "type": "array",
            "description": "Published flat-fee and per-person add-ons; not a complete extras quote.",
            "items": {
              "type": "object"
            }
          },
          "coverage": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "guidance": {
            "type": "string"
          },
          "next_action": {
            "type": "string"
          },
          "trips": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Trip"
            }
          }
        }
      },
      "Trip": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "destination": {
            "type": "string"
          },
          "duration_hours": {
            "type": "integer"
          },
          "base_price_thb": {
            "type": "integer",
            "nullable": true,
            "description": "Null; use quote for the selected date, group and extras."
          }
        }
      },
      "AvailabilityResponse": {
        "type": "object",
        "properties": {
          "generated": {
            "type": "string",
            "format": "date-time"
          },
          "start_date": {
            "type": "string",
            "format": "date"
          },
          "end_date": {
            "type": "string",
            "format": "date"
          },
          "range_days": {
            "type": "integer"
          },
          "data_source": {
            "type": "string"
          },
          "checked_at_scope": {
            "type": "string"
          },
          "guidance": {
            "type": "string"
          },
          "yachts": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "properties": {
                "booked": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "format": "date"
                  },
                  "description": "Fully booked dates"
                },
                "partial": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "format": "date"
                  },
                  "description": "Empty legacy field; no partial-day slots promised"
                },
                "available": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "format": "date"
                  },
                  "description": "Fresh calendar evidence and no active local booking"
                },
                "on_request": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "format": "date"
                  },
                  "description": "Missing, stale or incomplete calendar evidence"
                },
                "checked_at": {
                  "type": "string",
                  "format": "date-time",
                  "nullable": true,
                  "description": "Oldest observed mapped calendar update in the range; not proof of complete coverage"
                },
                "calendar_mapped": {
                  "type": "boolean"
                }
              }
            }
          }
        }
      },
      "PricingResponse": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date"
          },
          "currency": {
            "type": "string",
            "example": "THB"
          },
          "yachts": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "properties": {
                "fullday": {
                  "$ref": "#/components/schemas/PricingTier"
                },
                "halfday": {
                  "$ref": "#/components/schemas/PricingTier"
                },
                "overnight": {
                  "$ref": "#/components/schemas/PricingTier"
                }
              }
            }
          }
        }
      },
      "PricingTier": {
        "type": "object",
        "nullable": true,
        "properties": {
          "price": {
            "type": "integer",
            "description": "Public customer boat price in THB, identical to price_display; never an operator net price."
          },
          "price_display": {
            "type": "integer",
            "description": "Public website boat price including applicable VAT, rounded as on the website."
          },
          "inclpax": {
            "type": "integer",
            "description": "Passengers included in base price"
          },
          "extra_pax_price": {
            "type": "integer",
            "description": "Price per additional passenger"
          },
          "maxpax": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "Destination": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "yacht_count": {
            "type": "integer"
          },
          "min_price_thb": {
            "type": "integer",
            "nullable": true
          }
        }
      },
      "FleetSearchResponse": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date"
          },
          "adults": {
            "type": "integer"
          },
          "children": {
            "type": "integer"
          },
          "total_matching_yachts": {
            "type": "integer"
          },
          "next_offset": {
            "type": "integer",
            "nullable": true
          },
          "guidance": {
            "type": "string"
          },
          "budget_scope": {
            "type": "string",
            "nullable": true
          },
          "feature_guidance": {
            "type": "string"
          },
          "total_alternative_yachts": {
            "type": "integer"
          },
          "alternative_next_offset": {
            "type": "integer",
            "nullable": true
          },
          "offers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FleetOffer"
            }
          },
          "alternative_yachts": {
            "type": "array",
            "description": "Feature alternatives with explicit differences; all hard constraints still hold.",
            "items": {
              "$ref": "#/components/schemas/FleetOffer"
            }
          },
          "alternative_guidance": {
            "type": "string"
          },
          "alternative_dates": {
            "type": "array",
            "maxItems": 2,
            "description": "Separate fresh-calendar alternatives, independently paginated and priced.",
            "items": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "format": "date"
                },
                "offset_days": {
                  "type": "integer",
                  "enum": [
                    -1,
                    1
                  ]
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "checked",
                    "check_failed"
                  ]
                },
                "total_matching_yachts": {
                  "type": "integer"
                },
                "next_offset": {
                  "type": "integer",
                  "nullable": true
                },
                "total_alternative_yachts": {
                  "type": "integer"
                },
                "alternative_next_offset": {
                  "type": "integer",
                  "nullable": true
                },
                "offers": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/FleetOffer"
                  }
                },
                "alternative_yachts": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/FleetOffer"
                  }
                }
              }
            }
          }
        }
      },
      "FleetOffer": {
        "type": "object",
        "properties": {
          "yacht_type": {
            "type": "string",
            "nullable": true
          },
          "feature_match": {
            "type": "boolean"
          },
          "differences": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "feature": {
                  "type": "string"
                },
                "reason": {
                  "type": "string",
                  "enum": [
                    "not_available",
                    "not_available_for_trip",
                    "on_request"
                  ]
                }
              }
            }
          },
          "requested_features": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "enum": [
                    "included",
                    "optional_extra",
                    "on_request",
                    "not_available",
                    "not_available_for_trip"
                  ]
                },
                "source_text": {
                  "type": "string",
                  "nullable": true
                },
                "listed_amount": {
                  "type": "integer",
                  "nullable": true
                },
                "currency": {
                  "type": "string",
                  "enum": [
                    "THB"
                  ]
                },
                "basis": {
                  "type": "string",
                  "nullable": true
                }
              }
            }
          },
          "yacht_id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "source_url": {
            "type": "string",
            "format": "uri"
          },
          "details_url": {
            "type": "string",
            "format": "uri"
          },
          "tour": {
            "type": "object",
            "properties": {
              "duration_hours": {
                "type": "number",
                "nullable": true,
                "description": "Published duration of this specific tour in hours. Does not specify departure or return time."
              }
            }
          },
          "matching_tour_count": {
            "type": "integer"
          },
          "tour_options": {
            "type": "array",
            "maxItems": 3,
            "items": {
              "type": "object"
            }
          },
          "price": {
            "type": "object",
            "properties": {
              "amount": {
                "type": "integer",
                "nullable": true
              },
              "currency": {
                "type": "string",
                "enum": [
                  "THB"
                ]
              },
              "kind": {
                "type": "string",
                "enum": [
                  "from_price",
                  "not_calculated"
                ]
              },
              "all_in": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "reason": {
                "type": "string"
              }
            }
          },
          "availability": {
            "type": "object",
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "available",
                  "on_request"
                ]
              },
              "reason": {
                "type": "string",
                "enum": [
                  "fresh_calendar",
                  "no_online_calendar",
                  "slot_check_required",
                  "calendar_data_unavailable_or_stale"
                ]
              },
              "date": {
                "type": "string",
                "format": "date"
              },
              "checked_at": {
                "type": "string",
                "format": "date-time",
                "nullable": true
              },
              "scope": {
                "type": "string",
                "enum": [
                  "day",
                  "entire_trip"
                ]
              },
              "booking_confirmed": {
                "type": "boolean",
                "enum": [
                  false
                ]
              }
            }
          },
          "next_action": {
            "type": "string"
          }
        }
      }
    }
  }
}
