TravelPulse

{
  "properties": {
    "date": {
      "format": "date",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "park": {
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "park"
  ],
  "type": "object"
}

{
  "properties": {
    "date": {
      "description": "YYYY-MM-DD, default today",
      "format": "date",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "park": {
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "park"
  ],
  "type": "object"
}

{
  "properties": {
    "lang": {
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "park": {
      "description": "Park name or slug e.g. magic-kingdom, universal-studios-florida, europa-park",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "park"
  ],
  "type": "object"
}

{
  "properties": {
    "bag_received_date": {
      "description": "Baggage claims: date the bag was returned/received (YYYY-MM-DD) — computes the Art. 31 complaint deadline",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "block_time_hours": {
      "description": "India DGCA cancellations: scheduled block time in hours (estimated from distance if omitted, labeled [ESTIMATE])",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "carrier_country": {
      "description": "Operating carrier home country ISO code, or EU (default EU)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "carrier_size": {
      "description": "Canada APPR carrier size (default large)",
      "enum": [
        "large",
        "small"
      ],
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "date": {
      "description": "Incident/flight date YYYY-MM-DD — baggage: selects the effective Montreal SDR cap",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "delay_hours": {
      "description": "Arrival delay at final destination in hours (e.g. 4.5)",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "disruption": {
      "description": "delay | cancellation | denied_boarding | baggage_delay | baggage_damage | baggage_loss (default delay)",
      "enum": [
        "delay",
        "cancellation",
        "denied_boarding",
        "baggage_delay",
        "baggage_damage",
        "baggage_loss"
      ],
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "distance_km": {
      "description": "Great-circle distance override for airports outside the reference table",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "from": {
      "description": "Departure airport IATA code (e.g. FRA)",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "notice_days": {
      "description": "Cancellations: days of advance notice",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "reason": {
      "description": "Cause per the carrier (default unknown — burden of proof is the carrier's)",
      "enum": [
        "technical",
        "crew",
        "rotation_knock_on",
        "airline_staff_strike",
        "weather",
        "atc",
        "security",
        "external_strike",
        "bird_strike",
        "medical_diversion",
        "unknown"
      ],
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "to": {
      "description": "Final-destination airport IATA code (e.g. JFK)",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "from",
    "to",
    "delay_hours"
  ],
  "type": "object"
}

{
  "properties": {
    "airline": {
      "description": "Airline name for the letter",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "bag_received_date": {
      "description": "Baggage claims: date the bag was returned/received (Art. 31 deadline math)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "carrier_country": {
      "description": "Operating carrier home country ISO code, or EU (default EU)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "carrier_size": {
      "description": "Canada APPR carrier size (default large)",
      "enum": [
        "large",
        "small"
      ],
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "claim_value": {
      "description": "Baggage claims: documented damages with currency (e.g. '480 USD') — demanded in the letter, capped by the Montreal limit",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "delay_hours": {
      "description": "Arrival delay at final destination in hours (e.g. 4.5)",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "disruption": {
      "description": "delay | cancellation | denied_boarding | baggage_delay | baggage_damage | baggage_loss (default delay)",
      "enum": [
        "delay",
        "cancellation",
        "denied_boarding",
        "baggage_delay",
        "baggage_damage",
        "baggage_loss"
      ],
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "distance_km": {
      "description": "Great-circle distance override for airports outside the reference table",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "flight_date": {
      "description": "Flight date YYYY-MM-DD",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "flight_number": {
      "description": "Flight number (e.g. LH400)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "from": {
      "description": "Departure airport IATA code (e.g. FRA)",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Letter language (default English)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "notice_days": {
      "description": "Cancellations: days of advance notice",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "passenger_name": {
      "description": "Passenger name (placeholder used if omitted)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "reason": {
      "description": "Cause per the carrier (default unknown — burden of proof is the carrier's)",
      "enum": [
        "technical",
        "crew",
        "rotation_knock_on",
        "airline_staff_strike",
        "weather",
        "atc",
        "security",
        "external_strike",
        "bird_strike",
        "medical_diversion",
        "unknown"
      ],
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "to": {
      "description": "Final-destination airport IATA code (e.g. JFK)",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "from",
    "to",
    "delay_hours"
  ],
  "type": "object"
}

{
  "properties": {
    "destination": {
      "description": "Destination country or city",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "duration": {
      "description": "Number of days for total estimate",
      "required": false,
      "type": "number",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "style": {
      "description": "Travel style (default: mid-range)",
      "enum": [
        "budget",
        "mid-range",
        "luxury",
        "nomad"
      ],
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "destination"
  ],
  "type": "object"
}

{
  "properties": {
    "amount": {
      "description": "Amount to convert for reference calculation",
      "required": false,
      "type": "number",
      "x-parameter-location": "query"
    },
    "from": {
      "description": "Home currency (e.g. USD, EUR, GBP) — default: USD",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "to": {
      "description": "Destination currency or country name",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "to"
  ],
  "type": "object"
}

{
  "properties": {
    "destination": {
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "destination"
  ],
  "type": "object"
}

{
  "properties": {
    "airport": {
      "description": "Airport IATA code or city (e.g. JFK, Heathrow, Frankfurt)",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "date": {
      "description": "Travel date YYYY-MM-DD (defaults to near-term outlook)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language (any human language)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "airport"
  ],
  "type": "object"
}

{
  "properties": {
    "cabin": {
      "description": "economy | premium_economy | business | first",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "flexibility": {
      "description": "exact | ±3days | month",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "month_or_dates": {
      "description": "Target month or dates",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "route": {
      "description": "Route, e.g. 'LHR-JFK' or 'London to Tokyo'",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "route"
  ],
  "type": "object"
}

{
  "properties": {
    "destination": {
      "description": "Destination country or region",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "nationality": {
      "description": "Traveler nationality — some vaccines required only for specific nationals",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "trip_duration": {
      "description": "Trip duration (affects prophylaxis recommendations)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "destination"
  ],
  "type": "object"
}

{
  "properties": {
    "destination": {
      "description": "Trip destination",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "duration_days": {
      "description": "Trip duration in days",
      "required": false,
      "type": "number",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "trip_cost_usd": {
      "description": "Total prepaid trip cost in USD — for cancellation coverage sizing",
      "required": false,
      "type": "number",
      "x-parameter-location": "query"
    },
    "trip_type": {
      "description": "Trip type — determines coverage priorities",
      "enum": [
        "vacation",
        "nomad",
        "adventure",
        "backpacker",
        "business",
        "cruise"
      ],
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "destination"
  ],
  "type": "object"
}

{
  "properties": {
    "activities": {
      "description": "Planned activities (e.g. hiking, beach, business, diving, winter sports)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "bag_type": {
      "description": "Luggage constraint",
      "enum": [
        "carry-on",
        "checked",
        "backpack"
      ],
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "destination": {
      "description": "Travel destination",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "duration": {
      "description": "Trip duration in days",
      "required": false,
      "type": "number",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "destination"
  ],
  "type": "object"
}

{
  "properties": {
    "destination": {
      "description": "Destination country or language (e.g. Japan, Thai, Morocco)",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "focus": {
      "description": "Phrase focus area (transport, food, emergency, shopping, all)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language for explanations (phrases always in destination language)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "destination"
  ],
  "type": "object"
}

{
  "properties": {
    "budget": {
      "enum": [
        "budget",
        "mid-range",
        "luxury"
      ],
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "days": {
      "default": 5,
      "maximum": 14,
      "required": false,
      "type": "integer",
      "x-parameter-location": "query"
    },
    "destination": {
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "style": {
      "enum": [
        "cultural",
        "adventure",
        "relaxation",
        "foodie",
        "mixed"
      ],
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "destination"
  ],
  "type": "object"
}

{
  "properties": {
    "goal": {
      "description": "Redemption goal, e.g. 'business class to Japan' or 'free hotel week in Europe'",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "programs": {
      "description": "Comma-separated list of programs/cards the user holds",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "region": {
      "description": "Country/region the user holds cards/programs in",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "goal",
    "region"
  ],
  "type": "object"
}

{
  "properties": {
    "context": {
      "description": "Context hint (menu, sign, conversation, product)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "from_lang": {
      "description": "Source language (auto-detected if omitted)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "text": {
      "description": "Text to translate",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "to_lang": {
      "description": "Target language (default: English)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "text"
  ],
  "type": "object"
}

{
  "properties": {
    "dates": {
      "description": "Travel window, free-form (e.g. 2026-09-10 to 2026-09-20)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "destination": {
      "description": "Destination country or city (e.g. Japan, Paris, Kenya)",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language (any human language)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "passport": {
      "description": "Passport nationality (e.g. US, UK, India, Brazil, Nigeria)",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "passport",
    "destination"
  ],
  "type": "object"
}

{
  "properties": {
    "destination": {
      "description": "Destination country (e.g. Japan, France, Thailand, Kenya)",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "passport": {
      "description": "Passport nationality (e.g. US, UK, India, Brazil, Nigeria). `nationality` accepted as an alias.",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "purpose": {
      "description": "Visit purpose (tourism, business, nomad, transit)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "passport",
    "destination"
  ],
  "type": "object"
}

{
  "properties": {
    "destination": {
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "destination"
  ],
  "type": "object"
}