openapi: 3.0.3 info: title: Private Yacht Thailand API description: | Read-only API for private yacht charter listings in Thailand. Search, yacht details and configured quotes identify charter_product: exclusive use of the entire yacht with captain and crew, not a shared-tour ticket. Search 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. Covers Phuket, Krabi, Koh Samui and surrounding islands. Provides yacht details, calendar-backed availability, seasonal pricing, and trip destinations. Availability assurances end today plus three calendar months inclusive (Asia/Bangkok, month-end clamped). Later dates are on_request; known bookings remain blocked. Applies to search, alternatives, range and quote. Prices remain calculable beyond that cutoff. availability_policy.available_through gives the current cutoff. Yacht details include guide_languages with published yacht-specific guide languages, source and scope. Yacht 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. Menu descriptions preserve HTML line breaks as plain text; menu names and prices stay unchanged. Yacht 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. Search 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. Overnight 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. Calculated 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. Quote 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. Multi-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. Child 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. Optional 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. Yachts 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. Search 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). inquiry.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. All prices in Thai Baht (THB). No authentication required. 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, get_yacht_details and calculate_quote. Uses the same services as the REST API. No authentication required for public data. Negotiate initialize, then notifications/initialized. Supported versions are 2025-11-25, 2025-06-18 and 2025-03-26. Server-side clients are supported; existing REST browser CORS policy is unchanged. GET returns 405 because no standalone SSE stream is offered. No booking or payment actions. 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 yachts with matching day or standard overnight tours and comparison prices, not all-in quotes. Available means a fresh calendar check, never a reservation. Otherwise availability is on_request, with a separate technical reason. Booked yachts are omitted. Children count toward capacity. Overnight comparisons include child surcharges; day-trip child totals require calculate_quote. Destination matches are exact, case-insensitive names from the tour data. Up to three matching tour options per yacht are returned. Optional yacht_id selects one yacht. flex_days=1 checks the previous and next day only when no matching yacht is available on the requested date, across all pages. Defaults to 1 for a targeted yacht, otherwise 0. Alternative dates are separate suggestions with fresh availability and independently calculated prices; they never change the requested date. Same-day/past and out-of-range alternatives are skipped. A failed alternative check does not discard the main result. 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. Each 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. Maximum 90 inclusive dates; both dates must be tomorrow through tomorrow + 365 days. Shared 20-second response cache and request/concurrency limits apply. 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 (peak, regular, low). Shows the cheapest trip per type (fullday, halfday, overnight). 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}