Sparkling Tracks Tours

{'type': 'object', 'properties': {'to': {'type': 'string', 'description': 'Latest departure date, ISO YYYY-MM-DD.'}, 'from': {'type': 'string', 'description': 'Earliest departure date, ISO YYYY-MM-DD.'}, 'limit': {'type': 'number', 'description': 'Maximum trips to return, 1 to 50. Default 20.'}, 'max_days': {'type': 'number', 'description': 'Maximum trip length in days.'}, 'min_days': {'type': 'number', 'description': 'Minimum trip length in days.'}, 'max_price': {'type': 'number', 'description': 'Maximum per-person price in EUR.'}, 'destination': {'type': 'string', 'description': 'Country or city, matched loosely against countries, cities and trip titles. Omit to search everywhere.'}, 'include_unsellable': {'type': 'boolean', 'description': 'Include closed departures. Default false. Only set this to explain why a date is unavailable, never to offer one.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['date'], 'properties': {'date': {'type': 'string', 'description': 'Departure date, ISO YYYY-MM-DD.'}, 'title': {'type': 'string', 'description': 'Trip title, only when no tripId is available. If it names more than one trip the call is refused and the candidates are returned with their ids.'}, 'trip_id': {'type': 'number', 'description': 'The tripId returned by check_availability. PREFER THIS: titles are not unique, and two different trips can share one on the same date at very different prices.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'category': {'enum': ['flights', 'hotels', 'cars', 'activities', 'esims'], 'type': 'string', 'description': 'Optional category filter. If omitted, all categories are returned.'}, 'currency': {'enum': ['EUR', 'USD', 'INR', 'CNY', 'GBP', 'CHF'], 'type': 'string', 'description': 'Currency for the price_localized fields. Conversion is approximate, EUR-based; the binding price at booking is always EUR. Unsupported values fall back to EUR. Default: EUR.'}, 'language': {'enum': ['en', 'de', 'nl', 'fr', 'es', 'zh'], 'type': 'string', 'description': 'Output language for translatable fields (city names, country names, trip titles, descriptions). Unsupported values fall back to English. Default: en. zh is Simplified Chinese.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'properties': {'currency': {'enum': ['EUR', 'USD', 'INR', 'CNY', 'GBP', 'CHF'], 'type': 'string', 'description': 'Currency for the price_localized fields. Conversion is approximate, EUR-based; the binding price at booking is always EUR. Unsupported values fall back to EUR. Default: EUR.'}, 'language': {'enum': ['en', 'de', 'nl', 'fr', 'es', 'zh'], 'type': 'string', 'description': 'Output language for translatable fields (city names, country names, trip titles, descriptions). Unsupported values fall back to English. Default: en. zh is Simplified Chinese.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'integer', 'description': 'Numeric package id (e.g. from list_packages or from /trips/:id).'}, 'currency': {'enum': ['EUR', 'USD', 'INR', 'CNY', 'GBP', 'CHF'], 'type': 'string', 'description': 'Currency for the price_localized fields. Conversion is approximate, EUR-based; the binding price at booking is always EUR. Unsupported values fall back to EUR. Default: EUR.'}, 'language': {'enum': ['en', 'de', 'nl', 'fr', 'es', 'zh'], 'type': 'string', 'description': 'Output language for translatable fields (city names, country names, trip titles, descriptions). Unsupported values fall back to English. Default: en. zh is Simplified Chinese.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'properties': {'query': {'type': 'string', 'description': 'Optional case-insensitive substring to filter destinations by city or country name in English (e.g. "spain", "lisbon"). If omitted, all featured destinations are returned.'}, 'currency': {'enum': ['EUR', 'USD', 'INR', 'CNY', 'GBP', 'CHF'], 'type': 'string', 'description': 'Currency for the price_localized fields. Conversion is approximate, EUR-based; the binding price at booking is always EUR. Unsupported values fall back to EUR. Default: EUR.'}, 'language': {'enum': ['en', 'de', 'nl', 'fr', 'es', 'zh'], 'type': 'string', 'description': 'Output language for translatable fields (city names, country names, trip titles, descriptions). Unsupported values fall back to English. Default: en. zh is Simplified Chinese.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'badge': {'type': 'string', 'description': 'Filter to packages carrying a marketing badge. Accepted values include: bestseller, new, most_romantic, young_travelers, couples_choice, selling_fast. Partial substring match.'}, 'date_to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'End of the travel date range (ISO YYYY-MM-DD, inclusive). Must be on or after date_from. When omitted: with a city query and date_from it defaults to date_from (a single day); without a city the range is open-ended.'}, 'currency': {'enum': ['EUR', 'USD', 'INR', 'CNY', 'GBP', 'CHF'], 'type': 'string', 'description': 'Currency for the price_localized fields. Conversion is approximate, EUR-based; the binding price at booking is always EUR. Unsupported values fall back to EUR. Default: EUR.'}, 'language': {'enum': ['en', 'de', 'nl', 'fr', 'es', 'zh'], 'type': 'string', 'description': 'Output language for translatable fields (city names, country names, trip titles, descriptions). Unsupported values fall back to English. Default: en. zh is Simplified Chinese.'}, 'date_from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Start of the travel date range (ISO YYYY-MM-DD). When the destination/query names a city on a package route, only packages whose stay in that city overlaps [date_from, date_to] are returned, each annotated with city_date_windows (departure, arrive, leave, tour day). Otherwise only packages that fit entirely inside the range are returned. date_from alone with a city means "in that city on exactly this day"; alone without a city it means "departing on or after this date".'}, 'destination': {'type': 'string', 'description': 'Case-insensitive substring match against city or country names in the itinerary (e.g. "italy", "amsterdam", "switzerland"). Match is run against the English source names regardless of language param.'}, 'duration_days': {'type': 'integer', 'description': 'Filter to packages with exactly this many days (parsed from the duration string, e.g. "12D/11N" is 12 days).'}, 'max_price_eur': {'type': 'number', 'description': 'Filter to packages with starting price at or below this EUR amount. Custom-quote packages (price not yet set) are always included.'}, 'traveler_count': {'type': 'integer', 'description': 'Number of travellers in the party. Does not affect filtering; included in the response note so the AI can mention quote variability.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['cities'], 'properties': {'month': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}$', 'description': 'Month of travel, ISO YYYY-MM (e.g. "2026-09"). Only journeys starting in that month are returned. Omit when the traveller has not chosen one.'}, 'cities': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1, 'description': 'Cities in the order the traveller wants to visit them, English or local spelling (e.g. ["Paris", "Prague", "Rome"]). The first is where the journey starts and the last is where it ends; the ones in between are wanted somewhere along the way. A city no guided section stays in becomes days we arrange ourselves rather than a reason to drop it.'}, 'nights': {'type': 'integer', 'description': 'Total nights the traveller has. Journeys longer than this are not returned at all, and nights left over once the guided sections are counted become days we arrange for them.'}, 'currency': {'enum': ['EUR', 'USD', 'INR', 'CNY', 'GBP', 'CHF'], 'type': 'string', 'description': 'Currency for the price_localized fields. Conversion is approximate, EUR-based; the binding price at booking is always EUR. Unsupported values fall back to EUR. Default: EUR.'}, 'language': {'enum': ['en', 'de', 'nl', 'fr', 'es', 'zh'], 'type': 'string', 'description': 'Output language for translatable fields (city names, country names, trip titles, descriptions). Unsupported values fall back to English. Default: en. zh is Simplified Chinese.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['name', 'email', 'cities'], 'properties': {'name': {'type': 'string', 'description': 'Lead traveller name.'}, 'email': {'type': 'string', 'description': 'Contact email address.'}, 'month': {'type': 'string', 'description': 'ISO month YYYY-MM.'}, 'notes': {'type': 'string', 'description': 'Anything else the traveller wants us to know.'}, 'phone': {'type': 'string', 'description': 'Contact phone, with country code.'}, 'cities': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1, 'description': 'Cities the traveller wants to visit.'}, 'nights': {'type': 'integer', 'description': 'Total nights for the journey.'}, 'party_size': {'type': 'integer', 'description': 'Number of travellers.'}, 'preferred_option_index': {'type': 'integer', 'description': 'Which option they preferred: 0 for the first, 1 for the second, etc.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['title', 'departure_date', 'travellers', 'name', 'email'], 'properties': {'ages': {'type': 'string', 'description': 'Coarse age bands only, for trips with an age policy, for example "2 adults, 1 child 9". Never a full date of birth.'}, 'name': {'type': 'string', 'description': 'Lead traveller name.'}, 'email': {'type': 'string', 'description': 'Contact email address.'}, 'notes': {'type': 'string', 'description': 'Anything else the traveller wants us to know.'}, 'phone': {'type': 'string', 'description': 'Contact phone, with country code.'}, 'rooms': {'type': 'string', 'description': 'Room split, for example "1 twin + 1 single".'}, 'title': {'type': 'string', 'description': 'Trip title, only when no tripId is available.'}, 'dietary': {'type': 'string', 'description': 'Dietary requirements.'}, 'trip_id': {'type': 'number', 'description': 'The tripId returned by check_availability. PREFER THIS: it names exactly one trip. A title can name several, and the request is refused rather than guessing which.'}, 'occupancy': {'type': 'string', 'description': 'Twin, Single, Triple, Twin Share, or cabin class for a cruise.'}, 'travellers': {'type': 'number', 'description': 'Party size, 1 to 40.'}, 'nationality': {'type': 'string', 'description': 'Drives visa requirement. Not an identity document.'}, 'accessibility': {'type': 'string', 'description': 'Accessibility or mobility requirements.'}, 'needs_flights': {'type': 'boolean', 'description': 'Whether they want flights quoted alongside the trip.'}, 'departure_city': {'type': 'string', 'description': 'Where the traveller would fly from, for a flight quote.'}, 'departure_date': {'type': 'string', 'description': "ISO YYYY-MM-DD, must be one of that trip's departures."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'description': 'Maximum results to return. Clamped to the server cap of 25; values above it are ignored rather than honoured.'}, 'query': {'type': 'string', 'description': 'Case-insensitive substring matched against the tour name, the countries it visits, and the cities on its route (e.g. "portugal", "fatima", "scandinavia").'}, 'country': {'type': 'string', 'description': 'Case-insensitive substring matched against the countries visited only (e.g. "portugal"). Use this instead of query when the user named a country rather than a theme.'}, 'currency': {'enum': ['EUR', 'USD', 'INR', 'CNY', 'GBP', 'CHF'], 'type': 'string', 'description': 'Currency for the price_localized fields. Conversion is approximate, EUR-based; the binding price at booking is always EUR. Unsupported values fall back to EUR. Default: EUR.'}, 'days_max': {'type': 'integer', 'description': 'Only tours lasting at most this many days.'}, 'days_min': {'type': 'integer', 'description': 'Only tours lasting at least this many days.'}, 'language': {'enum': ['en', 'de', 'nl', 'fr', 'es', 'zh'], 'type': 'string', 'description': 'Output language for translatable fields (city names, country names, trip titles, descriptions). Unsupported values fall back to English. Default: en. zh is Simplified Chinese.'}, 'max_price_eur': {'type': 'number', 'description': 'Only tours whose starting price is at or below this EUR amount.'}, 'min_price_eur': {'type': 'number', 'description': 'Only tours whose starting price is at or above this EUR amount.'}, 'has_departures': {'type': 'boolean', 'description': 'true keeps only tours with a fixed departure still ahead on the published calendar; false keeps only the dates-on-request tours. Omit for both.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'City or country name in English (e.g. "Lisbon", "Switzerland", "Czech").'}, 'date_to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'End of the travel date range (ISO YYYY-MM-DD, inclusive). Must be on or after date_from. When omitted: with a city query and date_from it defaults to date_from (a single day); without a city the range is open-ended.'}, 'currency': {'enum': ['EUR', 'USD', 'INR', 'CNY', 'GBP', 'CHF'], 'type': 'string', 'description': 'Currency for the price_localized fields. Conversion is approximate, EUR-based; the binding price at booking is always EUR. Unsupported values fall back to EUR. Default: EUR.'}, 'language': {'enum': ['en', 'de', 'nl', 'fr', 'es', 'zh'], 'type': 'string', 'description': 'Output language for translatable fields (city names, country names, trip titles, descriptions). Unsupported values fall back to English. Default: en. zh is Simplified Chinese.'}, 'date_from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Start of the travel date range (ISO YYYY-MM-DD). When the destination/query names a city on a package route, only packages whose stay in that city overlaps [date_from, date_to] are returned, each annotated with city_date_windows (departure, arrive, leave, tour day). Otherwise only packages that fit entirely inside the range are returned. date_from alone with a city means "in that city on exactly this day"; alone without a city it means "departing on or after this date".'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['phone', 'message'], 'properties': {'phone': {'type': 'string', 'description': 'Phone number with country code, e.g. +919876543210.'}, 'context': {'type': 'string', 'description': 'Why this message is being sent, for the team.'}, 'message': {'type': 'string', 'description': 'The exact message to send. Keep it short and friendly.'}}, 'additionalProperties': False}