{
    "openapi": "3.1.0",
    "info": {
        "title": "Himalayan Hiking: trips, departures and booking options",
        "version": "1.0.0",
        "description": "Read-only JSON for AI agents and apps: search treks, tours and jungle safaris in Nepal, list fixed departures and get booking options. Nothing is booked or paid through this API; bookings are requests the visitor submits on the booking form. The same data powers the WebMCP tools in /js/webmcp.js.",
        "contact": {
            "name": "Himalayan Hiking",
            "url": "https://himalayanhiking.com/contact-us"
        }
    },
    "servers": [
        {
            "url": "https://himalayanhiking.com"
        }
    ],
    "paths": {
        "/webmcp/trips": {
            "get": {
                "operationId": "searchTrips",
                "summary": "Search published trips (treks, tours, jungle safaris, climbs)",
                "parameters": [
                    {
                        "name": "q",
                        "in": "query",
                        "required": false,
                        "description": "Words to match, e.g. \"Everest\", \"safari\", \"Chitwan\"",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "category",
                        "in": "query",
                        "required": false,
                        "description": "Category slug from /webmcp/categories, e.g. \"jungle-safari-in-nepal\", \"everest-region\"",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "max_days",
                        "in": "query",
                        "required": false,
                        "description": "Maximum trip length in days",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "max_price",
                        "in": "query",
                        "required": false,
                        "description": "Maximum price per person in USD",
                        "schema": {
                            "type": "number",
                            "minimum": 0
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "{count, trips[]}: title, slug, url, markdown_url, days, grade, max_altitude, price_from_usd, summary, categories, booking_url",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/webmcp/departures": {
            "get": {
                "operationId": "listDepartures",
                "summary": "Upcoming fixed group departures",
                "parameters": [
                    {
                        "name": "trip",
                        "in": "query",
                        "required": false,
                        "description": "Trip slug to filter by, e.g. \"everest-base-camp-trek\"",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "{count, departures[]}: trip, trip_slug, start, end, price_usd, status, booking_url",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/webmcp/booking-options": {
            "get": {
                "operationId": "getBookingOptions",
                "summary": "Prices by group size, add-ons, departures and the booking form contract for one trip",
                "parameters": [
                    {
                        "name": "trip",
                        "in": "query",
                        "required": true,
                        "description": "Trip slug, e.g. \"chitwan-jungle-safari\"",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "{trip, currency, price_from_per_person_usd, group_price_tiers[], addons[], fixed_departures[], booking_form{url, fields[], what_happens, who_submits}}",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Unknown trip slug"
                    }
                }
            }
        },
        "/webmcp/categories": {
            "get": {
                "operationId": "listCategories",
                "summary": "Trip categories (trekking regions, tours, safaris) and destinations, with page and Markdown URLs",
                "responses": {
                    "200": {
                        "description": "{things_to_do[], destinations[]}",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "externalDocs": {
        "description": "Site guide for language models (llms.txt)",
        "url": "https://himalayanhiking.com/llms.txt"
    }
}