plan_trip
Plan a whole trip with Trip720
For a request to plan a trip with a budget. Plans a whole trip, home to home, against the traveller's total budget: flights, stays, transfers, activities, visas and daily costs. Returns up to six options, each with a Safe Trip Total (the whole trip with a contingency), the route, and every price labelled live (checked with the provider), estimate (Trip720's own, protection margin included) or official (a government fee), with a link to the option on trip720.travel where it is booked. Side effect: the trip is saved on Trip720 (kept 30 days) so it can be opened and booked; nothing is booked or paid. Limits: at most 6 travellers, 60 nights and 5 named places; flight fares are estimates in this quick build. A trip still being built comes back with status 'building' and its trip id.
输入参数pacebudget必填diningorigin必填intereststripFocusdepartDate必填returnDate必填travellers必填destination必填
get_trip
Read a Trip720 trip
Reads a trip already planned on Trip720, by its trip id: its status and, when ready, its options with every labelled price and booking link. Read only; trips are kept 30 days.
输入参数tripId必填
get_day_plan
Day-by-day plan of a Trip720 option
The day-by-day plan of one option of a trip already planned on Trip720 (the recommended option unless optionId is given): times, places and prices for each day. Read only; times marked typical are not from a timetable.
输入参数tripId必填optionId
trip_alternatives
Other choices for one item of a Trip720 trip
For one line of an option in a trip already planned on Trip720 (a stay, a flight, a transfer, an activity), the other choices the providers offer, numbered, each with its price and what it does to the whole trip's Safe Trip Total and budget. Line ids and option ids come from plan_trip or get_trip. Read only; searches the providers again.
输入参数lineId必填tripId必填optionId必填
swap_trip_item
Swap one item of a Trip720 trip
Replaces one line of an option with one of the numbered choices from trip_alternatives, and re-prices the whole trip as the website does. Returns the updated option and its Safe Trip Total before and after. Side effect: the trip saved on Trip720 changes; the previous choice can be chosen again the same way. Nothing is booked or paid.
输入参数choice必填lineId必填tripId必填optionId必填
destination_facts
What a place really costs, from Trip720
Trip720's checked facts for one destination, for travellers from Australia or the UK: what a day costs a person for food and getting around (street food, balanced, mostly restaurants), local transport and taxi prices, tourist tax, the most pleasant months, the visa for that home country, the sights not to miss with tips, and the total of a sample priced trip. Each figure comes from Trip720's research with its sources, in AUD or GBP. Read only; no booking or search is made. Places not covered say so and list the covered places in that country.
输入参数place必填homeCountry
check_entry_requirements
Visa and entry rules, from Trip720
Whether travellers need a visa or an electronic authorisation for a holiday, for each passport and each destination country: the rule's name, the minimum processing days and its source (official government pages where available). Read only.
输入参数countries必填passports必填
best_time_to_visit
Best time to visit a country, from Trip720
When to go to a country, month by month: the best months overall, each covered place's most pleasant months, and the busy holiday weeks to plan around. From climate data (NASA POWER) and Trip720's research. Read only.
输入参数country必填