{
    "openapi": "3.1.0",
    "info": {
        "title": "Lux4Rides AI Information Hub",
        "version": "1.0.0",
        "summary": "Read-only public facts about Lux4Rides chauffeur service: services, coverage, vehicles, policies and the booking handoff.",
        "description": "Public, read-only and unauthenticated. It cannot create a reservation, send a message, take a payment or read a customer record.\n\nStandard reservations: https://bookings.lux4rides.com/\nComplex, multi-vehicle, VIP and corporate itineraries: vip@lux4rides.com\nCalls: (424) 209-8001. Texts: (424) 209-2006.\n\nPrices are the current rate table or dated calculations, never a quote for a specific trip. Availability is never known here. Where a record says \"dispatch confirmation required\", repeat that instead of guessing.",
        "contact": {
            "name": "Lux4Rides VIP dispatch",
            "email": "vip@lux4rides.com",
            "url": "https://lux4rides.com/ai/"
        },
        "x-last-meaningful-update": "2026-11-22"
    },
    "servers": [
        {
            "url": "https://lux4rides.com/ai/v1"
        }
    ],
    "externalDocs": {
        "description": "Human-readable hub",
        "url": "https://lux4rides.com/ai/"
    },
    "paths": {
        "/catalog.json": {
            "get": {
                "operationId": "getCatalog",
                "summary": "Dataset index: every dataset, lookup and the rules for assistants.",
                "responses": {
                    "200": {
                        "description": "The catalog",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    }
                }
            }
        },
        "/business.json": {
            "get": {
                "operationId": "getBusiness",
                "summary": "Business identity, contact channels with their purpose, sister brands and the evidence behind \"why Lux4Rides\".",
                "responses": {
                    "200": {
                        "description": "Business record",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    }
                }
            }
        },
        "/services.json": {
            "get": {
                "operationId": "listServices",
                "summary": "All service families, one short answer each.",
                "responses": {
                    "200": {
                        "description": "Service list",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    }
                }
            }
        },
        "/services/{id}.json": {
            "get": {
                "operationId": "getService",
                "summary": "One service family: answer, who it fits, booking method, what to send and sources.",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "airport-transfer",
                                "private-aviation-fbo",
                                "black-car-point-to-point",
                                "hourly-as-directed",
                                "corporate-travel",
                                "vip-and-production",
                                "hotel-and-concierge",
                                "weddings-and-events",
                                "concerts-and-stadiums",
                                "group-and-sprinter",
                                "disneyland-and-theme-parks",
                                "family-and-car-seats",
                                "cruise-ports",
                                "intercity",
                                "senior-transportation",
                                "airline-crew",
                                "safe-rides",
                                "seasonal-and-events"
                            ]
                        },
                        "example": "family-and-car-seats"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Service record",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    },
                    "404": {
                        "description": "Unknown id; the body lists valid ids.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/vehicles.json": {
            "get": {
                "operationId": "listVehicles",
                "summary": "All vehicle classes with capacity and current rates from the booking system.",
                "responses": {
                    "200": {
                        "description": "Vehicle list",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    }
                }
            }
        },
        "/vehicles/{id}.json": {
            "get": {
                "operationId": "getVehicle",
                "summary": "One vehicle class: passengers, bags, child-seat eligibility, rates and what dispatch must confirm.",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "comfort-sedan",
                                "executive-sedan",
                                "luxury-suv",
                                "escalade-elite",
                                "sprinter"
                            ]
                        },
                        "example": "luxury-suv"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Vehicle record",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    },
                    "404": {
                        "description": "Unknown id.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/policies.json": {
            "get": {
                "operationId": "listPolicies",
                "summary": "All policies: waiting, Meet & Greet, child seats, gratuity, cancellation, hourly minimums, discounts and more.",
                "responses": {
                    "200": {
                        "description": "Policy list",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    }
                }
            }
        },
        "/policies/{id}.json": {
            "get": {
                "operationId": "getPolicy",
                "summary": "One policy with its values, source and verification date.",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "pricing",
                                "live-quote-and-availability",
                                "airport-waiting",
                                "pickup-waiting",
                                "meet-and-greet",
                                "child-seats",
                                "gratuity",
                                "cancellation",
                                "payment",
                                "round-trip",
                                "stops",
                                "hourly",
                                "event-zone-fee",
                                "online-discount",
                                "pets",
                                "mobility",
                                "licensing-and-insurance",
                                "what-we-are-not"
                            ]
                        },
                        "example": "child-seats"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Policy record",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    },
                    "404": {
                        "description": "Unknown id.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "The record has expired; the service is still offered.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/places.json": {
            "get": {
                "operationId": "listPlaces",
                "summary": "Airports, cities, venues and hotels with stable ids, aliases and coverage.",
                "responses": {
                    "200": {
                        "description": "Place list",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    }
                }
            }
        },
        "/places/{id}.json": {
            "get": {
                "operationId": "getPlace",
                "summary": "One place: aliases, coverage and the published pages that mention it.",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "sna"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Place record",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    },
                    "404": {
                        "description": "Unknown id.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/routes.json": {
            "get": {
                "operationId": "listRoutes",
                "summary": "Published directional route pages (from = pickup).",
                "responses": {
                    "200": {
                        "description": "Route page list",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    }
                }
            }
        },
        "/pages.json": {
            "get": {
                "operationId": "listPages",
                "summary": "Every public page in the XML sitemap with its category.",
                "responses": {
                    "200": {
                        "description": "Page list",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    }
                }
            }
        },
        "/route": {
            "get": {
                "operationId": "checkRoute",
                "summary": "Does Lux4Rides serve this pickup and drop-off, in this direction, and how is it booked?",
                "parameters": [
                    {
                        "name": "from",
                        "in": "query",
                        "required": true,
                        "description": "Pickup: an airport code, city, venue or hotel name.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "Santa Ana Airport"
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "required": true,
                        "description": "Drop-off.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "Disneyland Hotel"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Route check. coverage_status is one of online_bookable, dispatch_coordinated, custom_quote, dispatch_confirmation_required, not_verified, ambiguous.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    },
                    "400": {
                        "description": "A parameter is missing.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/match-vehicle": {
            "get": {
                "operationId": "matchVehicle",
                "summary": "Which vehicle fits these passengers, bags and child seats?",
                "parameters": [
                    {
                        "name": "passengers",
                        "in": "query",
                        "required": true,
                        "description": "Everyone riding, children included.",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 3
                    },
                    {
                        "name": "luggage",
                        "in": "query",
                        "required": false,
                        "description": "Number of bags.",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 3
                    },
                    {
                        "name": "child_seats",
                        "in": "query",
                        "required": false,
                        "description": "Car seats needed.",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1
                    },
                    {
                        "name": "boosters",
                        "in": "query",
                        "required": false,
                        "description": "Booster seats needed.",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 0
                    },
                    {
                        "name": "requests",
                        "in": "query",
                        "required": false,
                        "description": "Any special equipment, in a few words.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "stroller"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Vehicle match. fit_status is fits, fits_on_paper_dispatch_confirmation_required, multiple_vehicles_or_dispatch or missing_details.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    }
                }
            }
        },
        "/search": {
            "get": {
                "operationId": "searchServices",
                "summary": "Keyword search across services, policies, vehicles, places and every public page.",
                "parameters": [
                    {
                        "name": "q",
                        "in": "query",
                        "required": true,
                        "description": "A few words about the trip.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "sprinter wedding"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "required": false,
                        "description": "Results to return, 1 to 20.",
                        "schema": {
                            "type": "integer"
                        },
                        "example": 8
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Search results",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    }
                }
            }
        },
        "/handoff": {
            "get": {
                "operationId": "getBookingHandoff",
                "summary": "Where the traveller goes next: the booking portal or VIP dispatch, with a summary to copy. Carries no personal data.",
                "parameters": [
                    {
                        "name": "kind",
                        "in": "query",
                        "required": false,
                        "description": "standard, complex or unsure.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "complex"
                    },
                    {
                        "name": "from",
                        "in": "query",
                        "required": false,
                        "description": "Pickup place name (public places only).",
                        "schema": {
                            "type": "string"
                        },
                        "example": "Van Nuys Airport"
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "required": false,
                        "description": "Drop-off place name.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "Beverly Hills"
                    },
                    {
                        "name": "passengers",
                        "in": "query",
                        "required": false,
                        "description": "Passenger count.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "6"
                    },
                    {
                        "name": "vehicles_needed",
                        "in": "query",
                        "required": false,
                        "description": "Number of vehicles.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "3"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Booking handoff",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Not modified (send If-None-Match with the ETag)."
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "Error": {
                "type": "object",
                "required": [
                    "error"
                ],
                "properties": {
                    "error": {
                        "type": "object",
                        "required": [
                            "code",
                            "message"
                        ],
                        "properties": {
                            "code": {
                                "type": "string",
                                "enum": [
                                    "unknown_id",
                                    "unknown_endpoint",
                                    "missing_parameter",
                                    "method_not_allowed",
                                    "expired"
                                ]
                            },
                            "message": {
                                "type": "string"
                            }
                        }
                    },
                    "catalog": {
                        "type": "string",
                        "format": "uri"
                    },
                    "help": {
                        "type": "string"
                    }
                }
            }
        }
    }
}