Currently the only acceptable value is v1.
Request Body Parameters The limit on the number of trips to return.
If requesting another set of trips, this will apply the offset to the next set of trips.
An array of string values of either TZ or KE, or both.
The maximum price of the trips that are returned within a given calendar year. The prices are per person, and based on 2 travellers.
For example if you set this as 3000 only packages that have a max price under 3000 will be returned.
The minimum price of the trips that are returned within a given calendar year. The prices are per person, and based on 2 travellers.
For example if you set this as 3000 only packages that have a min price over 3000 will be returned.
An array of string values of either SAFARI or KILIMANJARO, or both. This will return trips that are associated with the required guide tags that are passed.
For example, passing in ["KILIMANJARO"] will only return trips that require a guide for Kilimanjaro.
The ids of the destinations. If supplied this will only return trips that contain at least one of the given destination ids.
The ids of the properties. If supplied this will only return trips that contain at least one of the given properties.
The ids of the desired suppliers. THis will return only trips provided by the chosen suppliers.
The desired start date (isoString) of the trip.
The desired maximum length of the trip
The number of travellers on the trip
Return only featured trips. Featured trips are designated by CloudSafaris based on popularity, trending, or promoted.
The travellers travel style preferences. The available options are: [“Wildlife”, “Culture”, “Photography”, “Relaxation”, “Active”, “Mountain Climbing”, “Beach”]
Descriptor for the type of traveller(s) on the of trip: [“Friends”, “Family”, “Couples”, “Solo”]
{ "limit" : 2 , "offset" : 10 , "countries" : [ "KE" ], "max_price" : 1500 , "min_price" : 1000 , "required_guides" : [ "SAFARI" ], "destinations" : [ 3 ], "properties" : [ 1 , 2 ], "suppliers" : [ 1 ], "date" : "2024-10-05T14:48:00.000Z" , "days" : 7 , "number_of_travellers" : 2 , "featured" : false , "traveller_preferences" : [ "Wildlife" ], "traveller_type" : [ "Couples" ] } Response Body Parameters The total number of trips in our database
The number of trips returned after any filters or length limits are applied
The trip id is the unique id of the trip returned.
The name of the the trip.
The overview of the trip (overall description).
Countries the trip will be taking place in.
The name of the supplier (local tour company) to fulfill the trip.
The URL for the logo of the supplier (local tour company).
The minimum number of travellers required to book the trip.
The URLs of the images that can be used for this trip.
The URLs of the images that can be used for this trip.
The url path we use to access the full trip page
Category of the trip as defined by the supplier.
If the discount is a fixed amount (i.e. $100 off) as defined by the ApplyPercentage flag, it will be set here.
If the discount is a fixed amount (i.e. 10% off) as defined by the ApplyPercentage flag, it will be set here.
Flag defining whether to apply fixed or percentage discount.
Flag for promotions selling packages at cost.
Date isoString defining the expiration date of the promotion.
A short description for the trip.
A call to action for this trip.
Descriptor for the type of traveller(s) on the of trip: [“Friends”, “Family”, “Couples”, “Solo”]
The travellers travel style preferences. The available options are: [“Wildlife”, “Culture”, “Photography”, “Relaxation”, “Active”, “Mountain Climbing”, “Beach”]
The available options are: [“Best Seller”, “Fan Favourite”, “Top Rated”, “Most Popular”, “Highly Recommended”, “Trending Now”, “Must-see”, “Editor’s Choice”, “Hot Deal”, “Ultimate Experience”, “Exclusive Offer”]
{ "total_length" : 25 , "filtered_length" : 1 , "trips" : [ { "id" : 11 , "title" : "5 Day Tanzanian Safari, Savannah Tours" , "overview" : "A comprehensive 5-day safari experience starting from Arusha to Tarangire National Park with game drives and accommodations at Burunge Tented Lodge, among other destinations." , "countries" : [ "TZ" ], "pricing" : { "price" : 1200 , "currency" : "USD" }, "properties" : [ { "id" : 5 , "name" : "Burunge Tented Lodge - Tarangire" }, { "id" : 16 , "name" : "Marera Valley Lodge" } // Additional properties ] "suppliers" : [ { "name" : "Savannah Tours" , "logo_url" : "https://example.com/logo_url.jpg" } // Additional suppliers ], "min_pax" : 2 , "image_urls" : [ "https://cloudsafaris.com/path/to/image1.jpg" , "https://cloudsafaris.com/path/to/image2.jpg" ], "destinations" : [ { "id" : 7 , "name" : "Tarangire National Park" }, { "id" : 12 , "name" : "Lake Manyara National Park" } // Additional destinations ] "days" : 5 , "url" : "/5-day-tanzanian-safari-savannah-tours" , "route" : [], "trip_category" : "" , "promos" : [], "short_description" : "A comprehensive 5-day safari experience starting from Arusha to Tarangire National Park" , "why_this_trip" : "" , "traveller_type" : [ "Friends" , "Family" , "Couples" ], "traveller_preferences" : [ "Wildlife" , "Culture" , "Photography" , "Relaxation" , "Active" ], "popularity_tag" : "Best Seller" } // Additional trips ] } 
