{
  "openapi": "3.1.0",
  "info": {
    "title": "WhiteGloveGO Travel Concierge & Scoping API",
    "description": "Machine-readable interface for AI agents, copilots, and autonomous assistants to query itinerary structures and submit luxury travel consultation inquiries for WhiteGloveGO.",
    "version": "1.0.0",
    "contact": {
      "name": "WhiteGloveGO VIP Concierge",
      "email": "concierge@whiteglovego.com",
      "url": "https://whiteglovego.com/"
    }
  },
  "servers": [
    {
      "url": "https://formsubmit.co",
      "description": "Live AJAX Lead Capture Dispatcher"
    },
    {
      "url": "https://whiteglovego.com",
      "description": "Primary Web Host"
    }
  ],
  "paths": {
    "/ajax/concierge@whiteglovego.com": {
      "post": {
        "summary": "Submit a Traveler Consultation & Scoping Inquiry",
        "description": "Dispatches a structured traveler inquiry directly into WhiteGloveGO's private concierge inbox for review by a human Senior Travel Director.",
        "operationId": "submitTravelerInquiry",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InquiryRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Inquiry accepted and routed to VIP concierge inbox",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InquiryResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid payload or missing mandatory contact parameters"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "InquiryRequest": {
        "type": "object",
        "required": ["Client Name", "Email Address", "Phone / WhatsApp"],
        "properties": {
          "_subject": {
            "type": "string",
            "description": "Notification subject line",
            "default": "New WhiteGloveGO Inquiry via Agent API"
          },
          "_cc": {
            "type": "string",
            "format": "email",
            "default": "concierge@whiteglovego.com"
          },
          "Client Name": {
            "type": "string",
            "description": "Full name of the principal traveler",
            "example": "Eleanor Vance"
          },
          "Email Address": {
            "type": "string",
            "format": "email",
            "description": "Direct email address for itinerary proposals",
            "example": "eleanor.vance@example.com"
          },
          "Phone / WhatsApp": {
            "type": "string",
            "description": "International contact number including country code",
            "example": "+1 (415) 555-0192"
          },
          "Country": {
            "type": "string",
            "description": "Country of origin or residence",
            "example": "United States"
          },
          "Travel Party": {
            "type": "string",
            "description": "Party composition and traveler ages",
            "example": "Mature Couple (Ages 68 & 71)"
          },
          "Primary Region": {
            "type": "string",
            "description": "Chosen circuit or destinations of interest",
            "enum": [
              "The Royal Rajasthan & Golden Triangle Odyssey",
              "Sacred Ghats, Private Aarti & Himalayan Serenity",
              "Southern Sanctuaries, Spice Trails & Kerala Backwaters",
              "Riverbank Ayurvedic Wellness & Naturopathy Sanctuary",
              "The Golden Age Heritage & Thar Desert Camel Safari",
              "Royal Heritage & Ranthambore Bengal Tiger Safari",
              "Custom À La Carte Blend"
            ],
            "example": "The Royal Rajasthan & Golden Triangle Odyssey"
          },
          "Duration": {
            "type": "string",
            "description": "Estimated journey length",
            "example": "10-12 Days"
          },
          "Travel Season": {
            "type": "string",
            "description": "Target departure window",
            "example": "November - February"
          },
          "Accommodations Tier": {
            "type": "string",
            "description": "Preferred lodging category",
            "default": "5-Star Converted Royal Palaces (Taj, Oberoi, Leela)"
          },
          "Escort Detail": {
            "type": "string",
            "description": "Protective escort requirement",
            "default": "Dedicated Retired Indian Armed Forces Veteran Officer 24/7"
          },
          "Special Notes": {
            "type": "string",
            "description": "Mobility assistance needs, dietary restrictions, or medical considerations",
            "example": "Low-step MPV requested; mild mobility limitation for stairs; interested in gentle pulse diagnosis."
          },
          "Source": {
            "type": "string",
            "description": "Originating agent platform or assistant",
            "example": "Autonomous AI Agent"
          },
          "Reference Code": {
            "type": "string",
            "description": "Tracking identifier for the inquiry",
            "example": "WG-AGENT-10492"
          }
        }
      },
      "InquiryResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "string",
            "example": "true"
          },
          "message": {
            "type": "string",
            "example": "The form was submitted successfully."
          }
        }
      }
    }
  }
}
