{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "https://thejunglesafari.com/agent/inquiry-schema.json",
    "title": "The Jungle Safari, inquiry pre-fill schema",
    "description": "URL parameters that can be passed to /plan-your-safari to pre-populate the Plan Your Safari builder. All parameters are optional. Unknown or invalid values are ignored. Designed so AI agents and partners can deep-link travellers into a partially completed inquiry.",
    "version": "1.0.0",
    "lastUpdated": "2026-04-27",
    "baseUrl": "https://thejunglesafari.com/plan-your-safari",
    "method": "GET",
    "parameters": {
        "destinations": {
            "type": "string",
            "format": "csv",
            "description": "Comma-separated list of park slugs to add to the itinerary. Order is reordered by the builder for travel efficiency.",
            "validValues": [
                "corbett",
                "rajaji",
                "pangot",
                "sattal",
                "pilibhit",
                "dudhwa",
                "bandhavgarh",
                "kanha",
                "pench",
                "panna",
                "ranthambhore",
                "bharatpur",
                "kaziranga",
                "sunderbans",
                "manas",
                "agra",
                "jaipur",
                "khajuraho"
            ],
            "example": "corbett,bandhavgarh,kanha"
        },
        "start": {
            "type": "string",
            "format": "date",
            "description": "Tentative trip start date in ISO 8601 format (YYYY-MM-DD). Pre-fills the travel-date field.",
            "example": "2027-02-15"
        },
        "end": {
            "type": "string",
            "format": "date",
            "description": "Tentative trip end date in ISO 8601 format (YYYY-MM-DD). When provided alongside start, the builder uses (end - start) as the trip duration.",
            "example": "2027-02-25"
        },
        "duration": {
            "type": "integer",
            "minimum": 3,
            "maximum": 21,
            "description": "Trip length in days. Used directly when start/end are not provided. Clamped between 3 and 21.",
            "example": 8
        },
        "party": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20,
            "description": "Number of travellers (adults).",
            "example": 2
        },
        "children": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10,
            "description": "Number of children in the party.",
            "example": 0
        },
        "lodgeTier": {
            "type": "string",
            "enum": [
                "budget",
                "mid",
                "luxury"
            ],
            "description": "Preferred lodge tier. Currently surfaced in the inquiry notes; full UI integration is planned.",
            "example": "mid"
        },
        "name": {
            "type": "string",
            "maxLength": 200,
            "description": "Traveller full name. Pre-fills the contact form.",
            "example": "Asha Mehta"
        },
        "email": {
            "type": "string",
            "format": "email",
            "maxLength": 320,
            "description": "Traveller email. Pre-fills the contact form.",
            "example": "asha@example.com"
        },
        "phone": {
            "type": "string",
            "format": "phone",
            "description": "Traveller phone number. Accepts E.164 (+919812345678) or national format. Pre-fills the contact form.",
            "example": "+14155550123"
        },
        "country": {
            "type": "string",
            "format": "ISO-3166-1-alpha-2",
            "description": "Two-letter country code for the traveller. Pre-fills the country dropdown.",
            "example": "US"
        },
        "notes": {
            "type": "string",
            "maxLength": 2000,
            "description": "Free-form notes for the planner. Anniversary, photography focus, accessibility needs, etc. Pre-fills the message field.",
            "example": "Photography focus, anniversary trip, prefer mid-tier lodges."
        }
    },
    "exampleUrl": "https://thejunglesafari.com/plan-your-safari?destinations=corbett,bandhavgarh&start=2027-02-15&duration=8&party=2&lodgeTier=mid&name=Asha%20Mehta&email=asha%40example.com&phone=%2B14155550123&country=US&notes=Photography%20focus%2C%20anniversary%20trip.",
    "responses": {
        "behaviour": "The page loads and the builder applies all valid parameters as initial state. Invalid values are silently ignored. The user can adjust any pre-filled value before submitting the inquiry.",
        "fulfilment": "Submitting the form sends an inquiry email to the planning team. Replies typically arrive within one working day."
    },
    "relatedDocs": {
        "humansList": "https://thejunglesafari.com/llms.txt",
        "machineIndex": "https://thejunglesafari.com/llmindex.json"
    }
}