
Search and price Japan tours, tickets, ryokan, transfers, charter buses, helicopters, golf and eSIM.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Use this when the user asks whether a specific OlaChill tour or ticket can be booked on certain dates (for example 'is the teamLab ticket available on 20 March' or 'does the Fuji tour run next Saturday') and you have its product_id from search_travel_products; call search_travel_products first if you do not. Returns each date as open, closed or unknown. Read-only: nothing is reserved or held, and an open date can still sell out before checkout. Supports tour:… products (Japan day tours and multi-day tours) and ticket:… products; other products (ryokan, local tours) return 'unsupported' with the page link. Do not use it to book, for charter coaches, transfers or helicopter flights, or without a product_id. At most 31 days per call.
First date to check as YYYY-MM-DD (Japan time for Japan trips).
product_id returned by search_travel_products, e.g. tour:kawaguchiko-fuji-day-tour or ticket:tokyo-skytree-ticket.
Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en.
Last date to check (defaults to date_from; at most 31 days after it) as YYYY-MM-DD (Japan time for Japan trips).
Use this when the user asks whether a specific OlaChill tour or ticket can be booked on certain dates (for example 'is the teamLab ticket available on 20 March' or 'does the Fuji tour run next Saturday') and you have its product_id from search_travel_products; call search_travel_products first if you do not. Returns each date as open, closed or unknown. Read-only: nothing is reserved or held, and an open date can still sell out before checkout. Supports tour:… products (Japan day tours and multi-day tours) and ticket:… products; other products (ryokan, local tours) return 'unsupported' with the page link. Do not use it to book, for charter coaches, transfers or helicopter flights, or without a product_id. At most 31 days per call.
| Argument | Type | Description |
|---|---|---|
| locale | string | Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en. |
| date_to | string | Last date to check (defaults to date_from; at most 31 days after it) as YYYY-MM-DD (Japan time for Japan trips). |
| date_from* | string | First date to check as YYYY-MM-DD (Japan time for Japan trips). |
| product_id* | string | product_id returned by search_travel_products, e.g. tour:kawaguchiko-fuji-day-tour or ticket:tokyo-skytree-ticket. |
{
"type": "object",
"required": [
"product_id",
"date_from"
],
"properties": {
"locale": {
"enum": [
"en",
"ja",
"ko",
"zh",
"tw",
"es",
"fr",
"de",
"it",
"th",
"id",
"vi"
],
"type": "string",
"description": "Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en."
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last date to check (defaults to date_from; at most 31 days after it) as YYYY-MM-DD (Japan time for Japan trips)."
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First date to check as YYYY-MM-DD (Japan time for Japan trips)."
},
"product_id": {
"type": "string",
"maxLength": 120,
"description": "product_id returned by search_travel_products, e.g. tour:kawaguchiko-fuji-day-tour or ticket:tokyo-skytree-ticket."
}
},
"additionalProperties": false
}Use this when the user asks about an existing OlaChill booking, order or quotation request and gives both its reference (for example TOKY-1018-0427 or BUS-FR-1018-0427) and the email address used when booking. Returns the service, travel date, party size, current status and what happens next. Read-only. Do not use it to find new products, to change or cancel a booking (send the user to the manage-booking page it returns), or without both the reference and the email; never guess either.
| Argument | Type | Description |
|---|---|---|
| email* | string | Email address used for the booking. |
| locale | string | Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en. |
| booking_id* | string | Booking or request reference exactly as shown in the OlaChill email. |
{
"type": "object",
"required": [
"booking_id",
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"maxLength": 160,
"description": "Email address used for the booking."
},
"locale": {
"enum": [
"en",
"ja",
"ko",
"zh",
"tw",
"es",
"fr",
"de",
"it",
"th",
"id",
"vi"
],
"type": "string",
"description": "Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en."
},
"booking_id": {
"type": "string",
"maxLength": 60,
"minLength": 4,
"description": "Booking or request reference exactly as shown in the OlaChill email."
}
},
"additionalProperties": false
}Use this when the user wants a price for a specific charter trip with a bus, coach, minibus or van and driver: pickup, destination, date(s) and group size (for example '45-seat bus Tokyo to Hakone on 20 March for 40 people', a school trip, a company outing or a multi-day group itinerary). This is step 2 of the charter workflow, after or instead of search_charter_vehicles. Japan: returns the fixed 10-hour package price per vehicle per day, the number of vehicles and days, the overtime rate, and what is included or extra (tolls, parking, driver lodging). Europe (Schengen countries): returns an estimated price range from OlaChill's rate table. Every result is an estimate that OlaChill confirms after checking vehicle availability. Read-only: nothing is sent, saved or reserved. Do not use it to submit the request (use request_charter_quote once the user agrees), for bus or train tickets, or for 1–6 people on an airport run (use search_private_transfers).
| Argument | Type | Description |
|---|---|---|
| date* | string | Travel date as YYYY-MM-DD (Japan time for Japan trips). |
| locale | string | Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en. |
| pickup* | string | Pickup city, airport, station or address area, e.g. 'Narita Airport', 'Shinjuku', 'Paris CDG'. |
| region* | string | japan, or europe for Schengen countries. |
| country |
Use this as the fallback when the user asks about a Japan travel service that OlaChill offers but that none of the dedicated search tools covers, or asks in general what OlaChill offers: for example premium and luxury private tours, medical travel coordination, VIP arrival immigration at Narita or Haneda, self-drive car rental, fireworks festivals, destination guides, multi-day itineraries, the AI trip planner or real estate in Japan. Returns each service area with a short description, when it fits, and its page URL, plus the booking and group-transport contact addresses. Read-only. Do not use it instead of a dedicated tool: tours, tickets, activities and ryokan go to search_travel_products, helicopters to search_helicopter_experiences, airport cars to search_private_transfers, group buses to search_charter_vehicles, golf to search_golf_packages, cars with driver by the day or hour to search_chauffeur_services and eSIM to search_esim_plans. Do not call it to check whether OlaChill handles hotel bookings other than ryokan, airline flights, weather, restaurants or visas: OlaChill does not offer these, so answer without OlaChill tools.
| Argument | Type | Description |
|---|---|---|
| locale | string | Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en. |
{
"type": "object",
"properties": {
"locale": {
"enum": [
"en",
"ja",
"ko",
"zh",
"tw",
"es",
"fr",
"de",
"it",
"th",
"id",
"vi"
],
"type": "string",
"description": "Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en."
}
},
"additionalProperties": false
}Use this when the user asks for recommendations, suggestions, a shortlist, 'what should we do', or 'which option fits us' among bookable Japan tours, activities, cultural experiences, attraction or transport tickets, and ryokan, based on preferences such as area, interests, budget, private onsen or meal plan. It ranks only OlaChill catalogue items against the supplied criteria and returns explicit match reasons, considerations, the published 'from' price and product URL. Read-only. Use search_travel_products instead when the user names a specific product, attraction or route and mainly wants an exact inventory lookup. Do not use it for helicopter flights, private airport transfers, charter vehicles, airline flights, hotels other than ryokan, restaurants, weather, visas or general destination advice without a request for bookable options. Prices and availability can change; the product page has the final details.
| Argument | Type | Description |
|---|---|---|
| city | string | City or region in Japan to focus on, e.g. Tokyo, Kyoto, Hakone, Hokkaido. Any language. |
| limit | integer | Maximum number of results (1–8, default 5). |
| locale | string | Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en. |
| category | string | Optional product type to narrow the shortlist: tour, activity, cultural_experience, attraction_ticket, transport_ticket or ryokan. |
| interests | array |
Use this only when the user explicitly asks OlaChill to check availability and send a quotation for a charter coach, minibus or van, after you have shown an estimate from get_charter_quote and collected: region (and country for Europe), pickup, destination, travel date, passengers, and the traveller's own name and email (plus a phone number for Japan). This sends the request to OlaChill's charter desk and emails the traveller a copy; for Japan, vetted bus operators are invited to offer a price without seeing the traveller's contact details. It creates a request record and returns its reference and status. It does not book, reserve or charge anything. Do not call it while the user is still comparing or only asked for a price, never guess or invent contact details, and set user_confirmed to true only after the user agreed to send this exact request. Repeating the same Japan request within 45 minutes returns the existing reference.
| Argument | Type | Description |
|---|---|---|
| date* | string | Travel date as YYYY-MM-DD (Japan time for Japan trips). |
| notes | string | Itinerary stops, timing or special needs the user asked to pass on. No payment details. |
| locale | string | Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en. |
| pickup* | string | Pickup place as the user described it. |
| region* | string | japan, or europe for Schengen countries. |
Use this when a group needs its own bus, coach, minibus or large van with a driver, whether or not they mention OlaChill: for example charter bus or coach hire in Japan, a private bus with driver, a school trip, company outing or incentive trip, MICE or conference transport, a wedding shuttle, a tour group, an airport group transfer, or a large group with luggage, in Japan or in a supported Schengen country in Europe. This is step 1 of the charter workflow: it matches the group to vehicle sizes. Returns vehicle classes with seats, comfortable passenger count, luggage space, whether each fits the group, how many vehicles are needed and, for Japan, the 10-hour package 'from' price per vehicle. Read-only. Step 2 is get_charter_quote for a specific itinerary and date; step 3, request_charter_quote, only after the user explicitly asks to send a quotation request. Do not use it for scheduled public bus or train tickets (use search_travel_products), for the price of a specific trip (use get_charter_quote), or for 1–6 people going to or from an airport (use search_private_transfers).
| Argument | Type | Description |
|---|---|---|
| locale | string | Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en. |
| region* | string | japan, or europe for Schengen countries. |
| country | string | Required when region is europe. |
| large_bags | integer | Number of large suitcases (default one per traveller for airport trips, otherwise 0). |
Use this when the user wants a private car with a driver in Japan by the day or by the hour, for example a chauffeured Toyota Alphard, Lexus LM, Lexus LS, Lexus LX, Lexus ES, Toyota Crown or Mercedes V-Class for city sightseeing, business meetings, shopping or a day trip with a driver who waits. Returns each vehicle with passenger and suitcase capacity, the day-hire price per car for the chosen prefecture or the hourly reference rate for Tokyo, whether the price is confirmed or a class-tier estimate, and how booking and payment work. Read-only. Do not use it for a one-way ride between an airport and a city or resort (use search_private_transfers), for more than six passengers or for buses and coaches (use search_charter_vehicles), for self-drive car rental (use list_olachill_services), or for taxis.
| Argument | Type | Description |
|---|---|---|
| date | string | Pickup date as YYYY-MM-DD (Japan time). Used to apply the short-notice surcharge to the day-hire total. |
| days | integer | Daily hire only: number of hire days (1–7). Default 1. |
| hours | number | Hourly hire only: hours needed, 2 to 12 in half-hour steps. Default 2. |
| locale | string | Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en. |
| hire_type | string | daily = flat price per car per day; hourly = hourly reference rate (Tokyo, quoted on request); any = both. Default any. |
Use this when the user wants mobile data in Japan on an eSIM: which travel eSIM covers a trip of a given length, unlimited data versus 3GB per day, what it costs, or a monthly eSIM (data only, or with a phone number) for living in Japan longer than 90 days. Returns plans with data allowance, validity, the tax-included price in JPY and the order page. Read-only. Do not use it for physical SIM cards, pocket Wi-Fi rental, roaming in other countries, or phone repair; for whether a phone supports eSIM, point the user to the compatibility page in the result.
| Argument | Type | Description |
|---|---|---|
| data | string | Travel eSIM only: unlimited data, 3GB per day, or any. Default any. |
| days | integer | Number of days the user will be in Japan and needs data. Trips longer than 90 days return monthly plans. |
| locale | string | Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en. |
| stay_type | string | travel = short trip (up to 90 days); monthly = living in Japan, renewed every month. Default: travel when days is 90 or less, otherwise monthly. |
{
"type": "object",
"properties": {
"data": {
"enum": [
"unlimited",
"3gb_per_day",
"any"
],
"type": "string",
"description": "Travel eSIM only: unlimited data, 3GB per day, or any. Default any."
},
"days": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Number of days the user will be in Japan and needs data. Trips longer than 90 days return monthly plans."
},
"locale": {
"enum": [
"en",
"ja",
"ko",
"zh",
"tw",
"es",
"fr",
"de",
"it",
"th",
"id",
"vi"
],
"type": "string",
"description": "Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en."
},
"stay_type": {
"enum": [
"travel",
"monthly"
],
"type": "string",
"description": "travel = short trip (up to 90 days); monthly = living in Japan, renewed every month. Default: travel when days is 90 or less, otherwise monthly."
}
},
"additionalProperties": false
}Use this when the user wants to play golf in Japan with the round and transport arranged: a round at a named course near Tokyo, Mt Fuji, Hakone or Kansai (Kyoto, Osaka, Shiga), a one-day golf trip with hotel pickup from Tokyo, or a multi-day golf package (Tokyo, Hakone, Mt Fuji, Kyoto, Hokkaido, Okinawa). Returns each course or package with its area, the per-golfer price where OlaChill publishes one (golf only, or golf with a private transfer), optional add-ons, the club's own cancellation terms, and whether it can be paid online or is handled on request. Read-only. Do not use it for golf equipment shopping or driving ranges, for a car with driver without golf (use search_chauffeur_services), or for sightseeing tours and activities (use search_travel_products).
| Argument | Type | Description |
|---|---|---|
| days | integer | Trip length in days. 1 = a single round or one-day trip; 2 or more puts multi-day packages first. |
| limit | integer | Maximum number of results (1–20, default 8). |
| locale | string | Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en. |
| region | string | tokyo = Tokyo and around; fuji = Mt Fuji, Gotemba and Hakone; kansai = Kyoto, Osaka and Shiga; hokkaido and okinawa = multi-day packages only. Omit to list every area. |
| golfers | integer | Number of golfers. Used to show the total for each priced package (per-golfer price times golfers). |
Use this when the user wants a helicopter experience in Japan, whether or not they mention OlaChill: a Tokyo helicopter tour or sightseeing flight (including short 10–30 minute flights), a night-view flight, a Mt Fuji, Yokohama, Osaka or Kyoto helicopter flight, a private helicopter charter for a proposal, anniversary or special occasion, or a heli-taxi or helicopter transfer between two points. Returns each flight's area, duration, seats, whether seats are sold one by one or only as the whole aircraft, the 'from' price in JPY, the departure heliport, whether OlaChill confirms the slot with the operator, and the booking page. Read-only. Do not use it for airline flights between cities or countries, for ground transport, or for tours that do not involve a helicopter (use search_travel_products).
| Argument | Type | Description |
|---|---|---|
| area | string | Where the flight takes place. Omit to list all areas. |
| limit | integer | Maximum number of results (1–20, default 8). |
| locale | string | Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en. |
| passengers | integer | Party size, used to drop flights whose aircraft cannot carry the group. |
| time_of_day | string | Daytime or night-view flights. Default any. |
| service_type |
Use this when 1–6 travellers want a private car with a driver to or from a Japanese airport, whether or not they mention OlaChill: for example a Narita or Haneda transfer to a Tokyo hotel or district (Shinjuku, Shibuya, Ginza…), hotel to airport, Kansai Airport to Kyoto or Osaka, Itami, New Chitose to Sapporo or Niseko, Fukuoka, or a fixed Tokyo–ski resort route; also when a family or small group with large suitcases asks how much an airport private car or airport chauffeur costs. Returns fixed one-way prices per vehicle, the car, passenger and large-bag capacity, booking conditions and the booking page. Read-only. Do not use it for groups larger than one car or for buses and coaches (use search_charter_vehicles), for shared airport buses or limousine bus tickets (use search_travel_products with category transport_ticket), or for taxis and ride-hailing.
| Argument | Type | Description |
|---|---|---|
| locale | string | Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en. |
| airport | string | IATA code: NRT Narita, HND Haneda, KIX Kansai, ITM Osaka Itami, CTS New Chitose (Sapporo), FUK Fukuoka. Omit to list every route. |
| large_bags | integer | Number of large suitcases. |
| passengers | integer | Number of travellers. |
| destination | string | City, area or resort the user is going to or coming from, e.g. Shinjuku, Kyoto, Niseko. |
Use this when the user wants to find, compare or price things to do in Japan, whether or not they mention OlaChill: guided and private day tours and day trips (for example Mt Fuji, Hakone, Nikko, Kamikochi, Kyoto or Nara from Tokyo, Osaka or Nagoya), multi-day tours, local food and neighbourhood tours, street go-kart rides in Tokyo or Osaka, activities and cultural experiences (kimono rental, tea ceremony, cooking classes, crafts), attraction admission tickets (for example teamLab, Tokyo Skytree, theme parks, museums), transport tickets and passes (highway and overnight buses, airport buses, JR and regional rail passes) or a ryokan stay. Ryokan means a traditional Japanese inn, usually with onsen: search by area (Hakone, Kyoto, Ginzan, Kusatsu, Kinosaki, Kurokawa, Yufuin, Beppu and others) with category 'ryokan'; the filters private_onsen (private open-air baths in the room or a reservable private bath), meal_plan (dinner and breakfast), max_price_per_person_jpy and group_size (family or group stays; OlaChill also takes block-of-rooms and whole-inn requests on the ryokan pages) apply only then. Ryokan prices are dated reference prices, not live availability; OlaChill confirms rooms and the current price after the traveller sends dates on the ryokan page. Returns product ids, names, category, area, a 'from' price in JPY with its unit, booking method, key conditions and the product page URL. Read-only. Then use check_product_availability for dates of a tour or ticket. Do not use it for a bus, coach or minibus for a group (use search_charter_vehicles), a private car to or from an airport (use search_private_transfers), helicopter flights (use search_helicopter_experiences), single Shinkansen or train tickets and timetables, hotels other than ryokan, airline flights, restaurants, or general destination advice that does not need a bookable product. Provide at least one of query, city or category. Prices are 'from' prices; the final price and dates are confirmed on the product page.
| Argument | Type | Description |
|---|---|---|
| city | string | City or region in Japan, e.g. Tokyo, Kyoto, Osaka, Hokkaido. Any language. |
| string |
| Required when region is europe. |
| end_date | string | Last day for multi-day hire (omit for a single day) as YYYY-MM-DD (Japan time for Japan trips). |
| trip_type | string | Default one-way for one date, multi-day when end_date is after date. |
| large_bags | integer | Number of large suitcases. |
| passengers* | integer | Number of travellers. |
| destination | string | Main destination or 'round trip' area, e.g. 'Mt Fuji', 'Kyoto', 'Versailles'. |
| pickup_hour | integer | Pickup hour 0–23 local time (used for night surcharges in Europe). |
| vehicle_type | string | Optional vehicle_type from search_charter_vehicles. Omit to use the recommended size. |
{
"type": "object",
"required": [
"region",
"pickup",
"date",
"passengers"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Travel date as YYYY-MM-DD (Japan time for Japan trips)."
},
"locale": {
"enum": [
"en",
"ja",
"ko",
"zh",
"tw",
"es",
"fr",
"de",
"it",
"th",
"id",
"vi"
],
"type": "string",
"description": "Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en."
},
"pickup": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "Pickup city, airport, station or address area, e.g. 'Narita Airport', 'Shinjuku', 'Paris CDG'."
},
"region": {
"enum": [
"japan",
"europe"
],
"type": "string",
"description": "japan, or europe for Schengen countries."
},
"country": {
"enum": [
"france",
"italy",
"germany",
"switzerland",
"spain",
"netherlands",
"austria",
"czech-republic",
"portugal",
"belgium",
"poland",
"hungary",
"greece",
"croatia",
"denmark",
"sweden",
"norway",
"finland",
"iceland",
"estonia",
"latvia",
"lithuania",
"luxembourg",
"malta",
"slovakia",
"slovenia",
"romania",
"bulgaria"
],
"type": "string",
"description": "Required when region is europe."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day for multi-day hire (omit for a single day) as YYYY-MM-DD (Japan time for Japan trips)."
},
"trip_type": {
"enum": [
"one-way",
"round-trip",
"multi-day"
],
"type": "string",
"description": "Default one-way for one date, multi-day when end_date is after date."
},
"large_bags": {
"type": "integer",
"maximum": 500,
"minimum": 0,
"description": "Number of large suitcases."
},
"passengers": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Number of travellers."
},
"destination": {
"type": "string",
"maxLength": 120,
"description": "Main destination or 'round trip' area, e.g. 'Mt Fuji', 'Kyoto', 'Versailles'."
},
"pickup_hour": {
"type": "integer",
"maximum": 23,
"minimum": 0,
"description": "Pickup hour 0–23 local time (used for night surcharges in Europe)."
},
"vehicle_type": {
"type": "string",
"description": "Optional vehicle_type from search_charter_vehicles. Omit to use the recommended size."
}
},
"additionalProperties": false
}| Short traveller interests or trip preferences, e.g. food, culture, family, anime, autumn colors, luxury, honeymoon, skiing. Use short phrases, not the full conversation. |
| meal_plan | string | Ryokan only: dinner_breakfast, breakfast or room_only. |
| group_size | integer | Ryokan only: party size. For 10 or more guests, only inns with published group facilities qualify. |
| private_onsen | boolean | Ryokan only: true to require a room open-air bath or a reservable private bath. |
| max_price_per_person_jpy | integer | Optional budget ceiling in JPY per person. Applied when the catalogue price has a comparable per-person basis; other price units remain eligible and are flagged. |
{
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 60,
"description": "City or region in Japan to focus on, e.g. Tokyo, Kyoto, Hakone, Hokkaido. Any language."
},
"limit": {
"type": "integer",
"maximum": 8,
"minimum": 1,
"description": "Maximum number of results (1–8, default 5)."
},
"locale": {
"enum": [
"en",
"ja",
"ko",
"zh",
"tw",
"es",
"fr",
"de",
"it",
"th",
"id",
"vi"
],
"type": "string",
"description": "Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en."
},
"category": {
"enum": [
"tour",
"activity",
"cultural_experience",
"attraction_ticket",
"transport_ticket",
"ryokan"
],
"type": "string",
"description": "Optional product type to narrow the shortlist: tour, activity, cultural_experience, attraction_ticket, transport_ticket or ryokan."
},
"interests": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"maxItems": 8,
"description": "Short traveller interests or trip preferences, e.g. food, culture, family, anime, autumn colors, luxury, honeymoon, skiing. Use short phrases, not the full conversation."
},
"meal_plan": {
"enum": [
"dinner_breakfast",
"breakfast",
"room_only"
],
"type": "string",
"description": "Ryokan only: dinner_breakfast, breakfast or room_only."
},
"group_size": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Ryokan only: party size. For 10 or more guests, only inns with published group facilities qualify."
},
"private_onsen": {
"type": "boolean",
"description": "Ryokan only: true to require a room open-air bath or a reservable private bath."
},
"max_price_per_person_jpy": {
"type": "integer",
"maximum": 1000000,
"minimum": 1000,
"description": "Optional budget ceiling in JPY per person. Applied when the catalogue price has a comparable per-person basis; other price units remain eligible and are flagged."
}
},
"additionalProperties": false
}| company |
| string |
| Company, school or organisation, if the user mentioned one. |
| country | string | Required when region is europe. |
| end_date | string | Last day for multi-day hire as YYYY-MM-DD (Japan time for Japan trips). |
| large_bags | integer | Number of large suitcases. |
| passengers* | integer | Number of travellers. |
| destination* | string | Main destination as the user described it. |
| pickup_time | string | Pickup time HH:MM, 24-hour, local time. |
| contact_name* | string | Traveller's full name exactly as they gave it. |
| vehicle_type | string | vehicle_type from get_charter_quote. |
| contact_email* | string | Traveller's email exactly as they gave it; the quotation is sent here. |
| contact_phone | string | Traveller's phone with country code. Required for Japan requests. |
| vehicle_count | integer | Number of vehicles, from get_charter_quote. |
| user_confirmed* | boolean | Must be true: the user has reviewed the trip details and asked to send this request. |
| pickup_prefecture | string | Japan only: prefecture of the pickup, e.g. Tokyo, Osaka, Kyoto, Chiba. Helps OlaChill invite local operators. |
{
"type": "object",
"required": [
"user_confirmed",
"region",
"pickup",
"destination",
"date",
"passengers",
"contact_name",
"contact_email"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Travel date as YYYY-MM-DD (Japan time for Japan trips)."
},
"notes": {
"type": "string",
"maxLength": 1000,
"description": "Itinerary stops, timing or special needs the user asked to pass on. No payment details."
},
"locale": {
"enum": [
"en",
"ja",
"ko",
"zh",
"tw",
"es",
"fr",
"de",
"it",
"th",
"id",
"vi"
],
"type": "string",
"description": "Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en."
},
"pickup": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "Pickup place as the user described it."
},
"region": {
"enum": [
"japan",
"europe"
],
"type": "string",
"description": "japan, or europe for Schengen countries."
},
"company": {
"type": "string",
"maxLength": 120,
"description": "Company, school or organisation, if the user mentioned one."
},
"country": {
"enum": [
"france",
"italy",
"germany",
"switzerland",
"spain",
"netherlands",
"austria",
"czech-republic",
"portugal",
"belgium",
"poland",
"hungary",
"greece",
"croatia",
"denmark",
"sweden",
"norway",
"finland",
"iceland",
"estonia",
"latvia",
"lithuania",
"luxembourg",
"malta",
"slovakia",
"slovenia",
"romania",
"bulgaria"
],
"type": "string",
"description": "Required when region is europe."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day for multi-day hire as YYYY-MM-DD (Japan time for Japan trips)."
},
"large_bags": {
"type": "integer",
"maximum": 500,
"minimum": 0,
"description": "Number of large suitcases."
},
"passengers": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Number of travellers."
},
"destination": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "Main destination as the user described it."
},
"pickup_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Pickup time HH:MM, 24-hour, local time."
},
"contact_name": {
"type": "string",
"maxLength": 100,
"minLength": 2,
"description": "Traveller's full name exactly as they gave it."
},
"vehicle_type": {
"type": "string",
"description": "vehicle_type from get_charter_quote."
},
"contact_email": {
"type": "string",
"format": "email",
"maxLength": 160,
"description": "Traveller's email exactly as they gave it; the quotation is sent here."
},
"contact_phone": {
"type": "string",
"maxLength": 40,
"description": "Traveller's phone with country code. Required for Japan requests."
},
"vehicle_count": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Number of vehicles, from get_charter_quote."
},
"user_confirmed": {
"type": "boolean",
"const": true,
"description": "Must be true: the user has reviewed the trip details and asked to send this request."
},
"pickup_prefecture": {
"type": "string",
"maxLength": 40,
"description": "Japan only: prefecture of the pickup, e.g. Tokyo, Osaka, Kyoto, Chiba. Helps OlaChill invite local operators."
}
},
"additionalProperties": false
}| passengers* |
| integer |
| Number of travellers. |
{
"type": "object",
"required": [
"region",
"passengers"
],
"properties": {
"locale": {
"enum": [
"en",
"ja",
"ko",
"zh",
"tw",
"es",
"fr",
"de",
"it",
"th",
"id",
"vi"
],
"type": "string",
"description": "Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en."
},
"region": {
"enum": [
"japan",
"europe"
],
"type": "string",
"description": "japan, or europe for Schengen countries."
},
"country": {
"enum": [
"france",
"italy",
"germany",
"switzerland",
"spain",
"netherlands",
"austria",
"czech-republic",
"portugal",
"belgium",
"poland",
"hungary",
"greece",
"croatia",
"denmark",
"sweden",
"norway",
"finland",
"iceland",
"estonia",
"latvia",
"lithuania",
"luxembourg",
"malta",
"slovakia",
"slovenia",
"romania",
"bulgaria"
],
"type": "string",
"description": "Required when region is europe."
},
"large_bags": {
"type": "integer",
"maximum": 500,
"minimum": 0,
"description": "Number of large suitcases (default one per traveller for airport trips, otherwise 0)."
},
"passengers": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Number of travellers."
}
},
"additionalProperties": false
}| large_bags | integer | Number of large suitcases carried in the car. Default 0. |
| passengers | integer | Number of travellers in the car (children count as passengers). |
| prefecture | string | Japanese prefecture or major city of the pickup, in English, e.g. Tokyo, Osaka, Kyoto, Hokkaido, Kanagawa, Yokohama, Nagoya. Day-hire prices differ by prefecture. Omit for Tokyo prices. |
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Pickup date as YYYY-MM-DD (Japan time). Used to apply the short-notice surcharge to the day-hire total."
},
"days": {
"type": "integer",
"maximum": 7,
"minimum": 1,
"description": "Daily hire only: number of hire days (1–7). Default 1."
},
"hours": {
"type": "number",
"maximum": 12,
"minimum": 2,
"description": "Hourly hire only: hours needed, 2 to 12 in half-hour steps. Default 2."
},
"locale": {
"enum": [
"en",
"ja",
"ko",
"zh",
"tw",
"es",
"fr",
"de",
"it",
"th",
"id",
"vi"
],
"type": "string",
"description": "Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en."
},
"hire_type": {
"enum": [
"daily",
"hourly",
"any"
],
"type": "string",
"description": "daily = flat price per car per day; hourly = hourly reference rate (Tokyo, quoted on request); any = both. Default any."
},
"large_bags": {
"type": "integer",
"maximum": 30,
"minimum": 0,
"description": "Number of large suitcases carried in the car. Default 0."
},
"passengers": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Number of travellers in the car (children count as passengers)."
},
"prefecture": {
"type": "string",
"maxLength": 40,
"description": "Japanese prefecture or major city of the pickup, in English, e.g. Tokyo, Osaka, Kyoto, Hokkaido, Kanagawa, Yokohama, Nagoya. Day-hire prices differ by prefecture. Omit for Tokyo prices."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 14,
"minimum": 1,
"description": "Trip length in days. 1 = a single round or one-day trip; 2 or more puts multi-day packages first."
},
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Maximum number of results (1–20, default 8)."
},
"locale": {
"enum": [
"en",
"ja",
"ko",
"zh",
"tw",
"es",
"fr",
"de",
"it",
"th",
"id",
"vi"
],
"type": "string",
"description": "Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en."
},
"region": {
"enum": [
"tokyo",
"fuji",
"kansai",
"hokkaido",
"okinawa"
],
"type": "string",
"description": "tokyo = Tokyo and around; fuji = Mt Fuji, Gotemba and Hakone; kansai = Kyoto, Osaka and Shiga; hokkaido and okinawa = multi-day packages only. Omit to list every area."
},
"golfers": {
"type": "integer",
"maximum": 40,
"minimum": 1,
"description": "Number of golfers. Used to show the total for each priced package (per-golfer price times golfers)."
}
},
"additionalProperties": false
}| string |
| sightseeing = loop flight returning to the same heliport; transfer = point-to-point helicopter ride. Default any. |
{
"type": "object",
"properties": {
"area": {
"enum": [
"tokyo",
"yokohama",
"fuji",
"osaka",
"kyoto"
],
"type": "string",
"description": "Where the flight takes place. Omit to list all areas."
},
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Maximum number of results (1–20, default 8)."
},
"locale": {
"enum": [
"en",
"ja",
"ko",
"zh",
"tw",
"es",
"fr",
"de",
"it",
"th",
"id",
"vi"
],
"type": "string",
"description": "Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en."
},
"passengers": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Party size, used to drop flights whose aircraft cannot carry the group."
},
"time_of_day": {
"enum": [
"day",
"night",
"any"
],
"type": "string",
"description": "Daytime or night-view flights. Default any."
},
"service_type": {
"enum": [
"sightseeing",
"transfer",
"any"
],
"type": "string",
"description": "sightseeing = loop flight returning to the same heliport; transfer = point-to-point helicopter ride. Default any."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"locale": {
"enum": [
"en",
"ja",
"ko",
"zh",
"tw",
"es",
"fr",
"de",
"it",
"th",
"id",
"vi"
],
"type": "string",
"description": "Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en."
},
"airport": {
"enum": [
"NRT",
"HND",
"KIX",
"ITM",
"CTS",
"FUK"
],
"type": "string",
"description": "IATA code: NRT Narita, HND Haneda, KIX Kansai, ITM Osaka Itami, CTS New Chitose (Sapporo), FUK Fukuoka. Omit to list every route."
},
"large_bags": {
"type": "integer",
"maximum": 60,
"minimum": 0,
"description": "Number of large suitcases."
},
"passengers": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Number of travellers."
},
"destination": {
"type": "string",
"maxLength": 80,
"description": "City, area or resort the user is going to or coming from, e.g. Shinjuku, Kyoto, Niseko."
}
},
"additionalProperties": false
}| limit | integer | Maximum number of results (1–20, default 8). |
| query | string | What the user is looking for, e.g. 'mt fuji day trip', 'teamlab', 'sumo', 'airport bus'. Use the attraction or activity name, not a whole sentence. |
| locale | string | Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en. |
| category | string | tour = guided or private tours and day trips; activity = hands-on or outdoor activities; cultural_experience = kimono, tea ceremony, crafts, cooking; attraction_ticket = admission to a sight, museum, park or tower; transport_ticket = highway bus, airport bus, rail or ferry tickets and passes; ryokan = a stay at a traditional Japanese inn. |
| meal_plan | string | Ryokan only: dinner_breakfast = inns that serve dinner and breakfast; breakfast = inns that serve breakfast; room_only = inns with a room-only plan. |
| group_size | integer | Ryokan only: number of guests. 10 or more returns only inns with published group facilities (for example banquet rooms). |
| private_onsen | boolean | Ryokan only: true = only inns with rooms that have an open-air bath or a reservable private bath. |
| max_price_per_person_jpy | integer | Ryokan only: upper limit of the reference price per person per night in JPY. Inns without a current reference price are left out when this is set. |
{
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 60,
"description": "City or region in Japan, e.g. Tokyo, Kyoto, Osaka, Hokkaido. Any language."
},
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Maximum number of results (1–20, default 8)."
},
"query": {
"type": "string",
"maxLength": 120,
"description": "What the user is looking for, e.g. 'mt fuji day trip', 'teamlab', 'sumo', 'airport bus'. Use the attraction or activity name, not a whole sentence."
},
"locale": {
"enum": [
"en",
"ja",
"ko",
"zh",
"tw",
"es",
"fr",
"de",
"it",
"th",
"id",
"vi"
],
"type": "string",
"description": "Language for product names and page links (en, ja, ko, zh = Simplified Chinese, tw = Traditional Chinese, es, fr, de, it, th, id, vi). Default en."
},
"category": {
"enum": [
"tour",
"activity",
"cultural_experience",
"attraction_ticket",
"transport_ticket",
"ryokan"
],
"type": "string",
"description": "tour = guided or private tours and day trips; activity = hands-on or outdoor activities; cultural_experience = kimono, tea ceremony, crafts, cooking; attraction_ticket = admission to a sight, museum, park or tower; transport_ticket = highway bus, airport bus, rail or ferry tickets and passes; ryokan = a stay at a traditional Japanese inn."
},
"meal_plan": {
"enum": [
"dinner_breakfast",
"breakfast",
"room_only"
],
"type": "string",
"description": "Ryokan only: dinner_breakfast = inns that serve dinner and breakfast; breakfast = inns that serve breakfast; room_only = inns with a room-only plan."
},
"group_size": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Ryokan only: number of guests. 10 or more returns only inns with published group facilities (for example banquet rooms)."
},
"private_onsen": {
"type": "boolean",
"description": "Ryokan only: true = only inns with rooms that have an open-air bath or a reservable private bath."
},
"max_price_per_person_jpy": {
"type": "integer",
"maximum": 1000000,
"minimum": 5000,
"description": "Ryokan only: upper limit of the reference price per person per night in JPY. Inns without a current reference price are left out when this is set."
}
},
"additionalProperties": false
}