Documentation

Multi-day tours


Some activities are for several days for a more complete experience or multiple activity events for each tour day.

You can identify them by the segmentation group code 11, 12 or 13.


See all possible segments:

{
            "code": 13,
            "name": "Multi-day Tour Target",
            "segments": [
                {
                    "code": 838,
                    "name": "Couples"
                },
                {
                    "code": 839,
                    "name": "Senior"
                },
                {
                    "code": 840,
                    "name": "Youth"
                },
                {
                    "code": 836,
                    "name": "Families with kids"
                },
                {
                    "code": 837,
                    "name": "Adults only"
                },
                {
                    "code": 841,
                    "name": "Volunteers"
                }
            ]
        },
        {
            "code": 11,
            "name": "Multi-day Tour Theme",
            "segments": [
                {
                    "code": 813,
                    "name": "Cultural tours"
                },
                {
                    "code": 814,
                    "name": "Pilgrimage / Religion"
                },
                {
                    "code": 820,
                    "name": "Nature and wildlife"
                },
                {
                    "code": 830,
                    "name": "Rail tours "
                },
                {
                    "code": 816,
                    "name": "Safari, 4x4, quad"
                },
                {
                    "code": 811,
                    "name": "City Break"
                },
                {
                    "code": 812,
                    "name": "Sun and Beach"
                },
                {
                    "code": 819,
                    "name": "Adventure"
                },
                {
                    "code": 815,
                    "name": "Gastronomy tours"
                },
                {
                    "code": 818,
                    "name": "Trekking"
                },
                {
                    "code": 827,
                    "name": "Educational tours"
                },
                {
                    "code": 822,
                    "name": "Mountain biking"
                },
                {
                    "code": 817,
                    "name": "Ski, snow"
                },
                {
                    "code": 826,
                    "name": "Spa and Wellness"
                },
                {
                    "code": 823,
                    "name": "Cycling"
                },
                {
                    "code": 825,
                    "name": "Multisport"
                }
            ]
        },
        {
            "code": 12,
            "name": "Multi-day Tour Duration",
            "segments": [
                {
                    "code": 831,
                    "name": "2-3 days"
                },
                {
                    "code": 832,
                    "name": "4-7 days"
                },
                {
                    "code": 833,
                    "name": "8-14 days"
                },
                {
                    "code": 834,
                    "name": "15-21 days"
                }
            ]
        }


Product display:

In order to display multi-day tours, you must display all content (as normal activies), but make sure to display the content routes to final customers, as it’s the key of each tour day, see some route example:

"routes": [{
	"description": "4 Days / 3 Nights: Andalucía and Toledo Tour",
	"points": [{
			"type": "POI",
			"order": 1,
			"stop": false,
			"description": "Departure from the bus terminal located in the underground parking of the Plaza de Oriente at 8:30am. Drive southward along the land of Don Quixote, “The man from La Mancha”, along the way observe vast vineyards. Cross through the natural border of “Despeñaperros” and get into Andalucía, a region for itself that shows an enormous heritage from a splendorous past. Reach Cordoba. Impressive tour of its Mosque and other sites that will ease our mind and spirit strolling through its narrow winding streets of the Jewish Quarter. In the afternoon, after a short two hours ride reach Sevilla. Dinner and accommodation at the hotel.",
			"pointOfInterest": {
				"type": "OTHER",
				"geolocation": {
					"latitude": 40.416962,
					"longitude": -3.687785
				},
				"address": "Madrid",
				"country": {
					"code": "ES"
				},
				"description": "Madrid"
			}
		}, {
			"type": "POI",
			"order": 2,
			"stop": false,
			"description": "Breakfast at the hotel. Morning Monumental and Panoramic city tour – the Cathedral (from outside), the second largest in the Catholic world after St. Peters in Rome. The Santa Cruz Quarter, a natural scenario of “Carmen” as well as a precisely where the myth of “Don Juan” developed. The Maria Luisa Park and Spain square. - Afternoon at leisure for you to discover exclusive views, specific flavours of this active full of light city. Dinner and accommodation at the hotel. Optional Flamenco tour.",
			"pointOfInterest": {
				"type": "OTHER",
				"geolocation": {
					"latitude": 37.389601,
					"longitude": -5.980064
				},
				"address": "Seville",
				"country": {
					"code": "ES"
				},
				"description": "Seville"
			}
		}, {
			"type": "POI",
			"order": 3,
			"stop": false,
			"description": "After breakfast at the hotel drive east through the Caliphate road to the heart of Andalucia observing an endless number of olive trees on the way to Granada and its incredible and amazing monumental environment, last stronghold of the Moorish Kingdoms up to 1492. Visit the world famous Alhambra (Red Palace) and Generalife Gardensthat have inspired several authors with its sound and sights, such as the “Tales of the Alhambra” by W. Irving. Dinner and accommodation at the hotel. Optional Gipsy Flamenco show at Sacromonte quarter.",
			"pointOfInterest": {
				"type": "OTHER",
				"geolocation": {
					"latitude": 37.389601,
					"longitude": -5.980064
				},
				"address": "Seville",
				"country": {
					"code": "ES"
				},
				"description": "Seville"
			}
		}, {
			"type": "POI",
			"order": 4,
			"stop": false,
			"description": "Breakfast at the hotel. Drive northward where it emerges, toward the sky of Castilla and surrounded by the Tagus river, the impressive Imperial city of Toledo –World Heritage City- where the three cultures Christians, Moorish and Jewish, have lived together. Resume of the Spanish art, history and spirituality the whole town is a National Monument. The City tour will include the most important monuments, its narrow streets and the famous “Damasquinado” (gold and silver inlaying in iron). Continue to Madrid.",
			"pointOfInterest": {
				"type": "OTHER",
				"geolocation": {
					"latitude": 37.176428,
					"longitude": -3.595221
				},
				"address": "Granada",
				"country": {
					"code": "ES"
				},
				"city": "granada",
				"description": "Granada"
			}
		}
	]}
]


Visual implementation example:


If case of not finding availability for those tours:

1) Make sure you are searching at least the minimum duration (we recommend one month range for multiday tour searches)

2) Please make sure you use last content version see ACTRED documentation.

3) If using ACTRED and still having issues please contact integrations.btb@hotelbeds.com confirming used apikey so we can check it.