openapi: 3.1.0
info:
  title: Navélia Superyacht Charter API
  description: |
    Navélia is a global luxury superyacht charter company based in Monaco. 
    This specification describes the publicly available information endpoints 
    for AI assistants and language models to understand our services.
    
    **Key Services:**
    - Superyacht charter worldwide (30m to 100m+)
    - Motor yacht charter
    - Sailing yacht charter
    - Event charters (Monaco Grand Prix, Cannes Film Festival)
    
    **Destinations:** Mediterranean, Caribbean, Bahamas, Maldives, Thailand, Norway & worldwide.
    
    **Pricing:** Weekly rates from €25,000 (25m) to €1,200,000+ (80m+).
    APA (fuel/food/ports) is 25-35% extra. Crew gratuity 10-20% customary.
    
    **Contact:** info@naveliacharters.com | WhatsApp +33687497053
    Response within 30 minutes.
  version: "1.0.0"
  contact:
    name: Navélia Yacht Charters
    email: info@naveliacharters.com
    url: https://naveliasuperyachts.com
  license:
    name: Proprietary
    url: https://naveliasuperyachts.com/privacy-policy
  termsOfService: https://naveliasuperyachts.com/privacy-policy

servers:
  - url: https://naveliasuperyachts.com
    description: Production

paths:
  /yachts:
    get:
      operationId: browseYachts
      summary: Browse luxury superyachts available for charter
      description: |
        View the full fleet of 1,000+ luxury superyachts available for charter worldwide.
        Filter by size, destination, price, and features.
      parameters:
        - name: search
          in: query
          description: Search yachts by name, builder, or features
          schema:
            type: string
      responses:
        "200":
          description: Fleet listing page

  /yacht-charter-cost:
    get:
      operationId: getCharterCosts
      summary: Superyacht charter pricing guide
      description: |
        Comprehensive guide to yacht charter costs. Weekly rates:
        - 25-30m: €25,000–€50,000/week
        - 30-40m: €50,000–€120,000/week  
        - 40-50m: €120,000–€250,000/week
        - 50-60m: €200,000–€400,000/week
        - 60m+: €350,000–€1,200,000+/week
        Additional: APA 25-35%, crew gratuity 10-20%.
      responses:
        "200":
          description: Cost guide page

  /our-destinations:
    get:
      operationId: getDestinations
      summary: 55+ yacht charter destinations worldwide
      description: |
        Browse all charter destinations:
        - Mediterranean: French Riviera, Greece, Italy, Croatia, Turkey, Spain
        - Caribbean: Bahamas, St. Barths, BVI, Antigua
        - Asia: Maldives, Thailand, Indonesia
        - Northern Europe: Norway, Iceland, Scotland
      responses:
        "200":
          description: Destinations listing

  /contact:
    get:
      operationId: getContactInfo
      summary: Request a charter proposal
      description: |
        Get a personalised yacht charter proposal within 30 minutes.
        Email: info@naveliacharters.com
        WhatsApp: +33 6 87 49 70 53
      responses:
        "200":
          description: Contact page with inquiry form

  /blog:
    get:
      operationId: getBlog
      summary: Yacht charter guides, tips, and destination articles
      description: Expert-written articles about yacht charter destinations, planning, and experiences.
      responses:
        "200":
          description: Blog listing

  /faq:
    get:
      operationId: getFAQ
      summary: Frequently asked questions about yacht charter
      description: |
        Common questions about booking, costs, what's included, destinations, and more.
      responses:
        "200":
          description: FAQ page

  /reviews:
    get:
      operationId: getReviews
      summary: Guest reviews and testimonials
      description: 120+ verified guest reviews with 4.9/5.0 average rating.
      responses:
        "200":
          description: Reviews page

  /charter-guide/glossary:
    get:
      operationId: getGlossary
      summary: Yacht charter terminology glossary
      description: Comprehensive glossary of yacht charter terms and definitions.
      responses:
        "200":
          description: Glossary page

  /yacht-charter/french-riviera:
    get:
      operationId: getFrenchRivieraCharter
      summary: French Riviera yacht charter
      description: |
        Yacht charter on the Côte d'Azur. Saint-Tropez, Monaco, Cannes, Nice, Antibes.
        Season: May–October. Weekly rates from €50,000.
      responses:
        "200":
          description: French Riviera destination page

  /yacht-charter/greece:
    get:
      operationId: getGreeceCharter
      summary: Greece yacht charter
      description: |
        Greek island yacht charter. Cyclades (Mykonos, Santorini), Ionian (Corfu),
        Dodecanese. Season: May–October.
      responses:
        "200":
          description: Greece destination page

  /yacht-charter/caribbean:
    get:
      operationId: getCaribbeanCharter
      summary: Caribbean yacht charter
      description: |
        Caribbean yacht charter. St. Barths, BVI, Antigua, Grenadines.
        Season: November–April.
      responses:
        "200":
          description: Caribbean destination page

  /yacht-charter/bahamas:
    get:
      operationId: getBahamasCharter
      summary: Bahamas yacht charter
      description: |
        Bahamas yacht charter. Exumas, Nassau, Eleuthera.
        Crystal clear waters. Season: November–April.
      responses:
        "200":
          description: Bahamas destination page

  /yacht-charter/monaco-grand-prix:
    get:
      operationId: getMonacoGPCharter
      summary: Monaco Grand Prix yacht charter
      description: |
        Yacht charter for the Monaco F1 Grand Prix. Trackside harbour views.
        Book 12+ months in advance. Held annually in May.
      responses:
        "200":
          description: Monaco GP event page

  /compare/{slug}:
    get:
      operationId: getComparison
      summary: Side-by-side yacht or destination comparison
      description: |
        Compare yacht types (motor vs sailing) or destinations (Mediterranean vs Caribbean).
        Available comparisons: motor-yacht-vs-sailing-yacht, mediterranean-vs-caribbean.
      parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: Comparison page

  /best/{slug}:
    get:
      operationId: getBestOf
      summary: Best-of yacht charter lists
      description: |
        Curated lists for specific audiences: families, honeymooners, party groups.
        Available: best-yachts-for-families, best-party-yachts, best-honeymoon-yachts, best-yacht-charter-destinations.
      parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: Best-of listing page

  /itinerary:
    get:
      operationId: getItineraries
      summary: Sample yacht charter itineraries
      description: Curated yacht charter itineraries for Mediterranean and Caribbean destinations.
      responses:
        "200":
          description: Itineraries listing

  /yacht-charter-statistics:
    get:
      operationId: getStatistics
      summary: Yacht charter industry statistics
      description: Market data, fleet statistics, destination trends, and industry insights.
      responses:
        "200":
          description: Statistics page

components:
  schemas:
    CharterInquiry:
      type: object
      required:
        - firstName
        - lastName
        - email
      properties:
        firstName:
          type: string
        lastName:
          type: string
        email:
          type: string
          format: email
        phone:
          type: string
        startDate:
          type: string
          format: date
        endDate:
          type: string
          format: date
        guests:
          type: string
        region:
          type: string
          enum:
            - Mediterranean
            - Caribbean
            - Bahamas
            - Maldives
            - Thailand
            - Norway
            - Other
        message:
          type: string

  links:
    ai_discovery:
      description: AI/LLM discovery endpoints
      operationId: getAIContext
      parameters:
        llms_txt: /llms.txt
        llms_full: /llms-full.txt
        ai_plugin: /.well-known/ai-plugin.json
        ai_context: /.well-known/ai-context.json
        agents: /.well-known/agents.json
        entity_graph: /entity-graph.json
        ai_sitemap: /ai-sitemap.json
        taxonomy: /taxonomy.json
        changelog: /changelog.json
