A collection of endpoints which can be used to search the catalog for relevant activities.
Musement API (3.5.0)
For merchant or affiliate partners wishing to use the Musement API.
See the Authentication section for details on how to authenticate with the API.
GET /activities/{activityUuid}/dates/{date}- Added
availability,max_buyandmin_buyproperties to timeslots. For more info, check out our guide
- Added
Filter activities by their available dates. Only activities with at least one available date after this parameter value are returned.
Must be used together with available_to parameter.
Filter activities to those which accommodate at least one of the specified languages.
Filter activities by their available dates. Only activities with at least one available date before this parameter value are returned.
Must be used together with available_from parameter.
Filter results to those which use at least one of the specified categories.
Filter results to those which are connected to at least one of the specified cities.
Filter results to those located near the specified latitude and longitude. Separate the coordinates with a comma.
Must be used together with the distance parameter.
Filter results to those which are connected to at least one of the specified countries.
Filter results by price. Results will contain pricing which falls between the two specified amounts.
Parameter requires two values, a lower and upper bound, separated by a comma. Each value must be a float or integer. Parameter accepts up to two decimal digits.
This parameter uses the currency value in the X-Musement-Currency header.
Filter results to activities located within the specified radius around a pair of coordinates. Parameter must include one of the following units:
KM: kilometersM: miles
Must be used together with the coordinates parameter.
Filter results by discount:
NO: return activities without discounts.YES: only return activities with discounts.
Filter results by their duration. Parameter can accept a single lower bound value or both a lower and upper bound separated by a comma.
Parameter values are treated as hours. Values can have up to two decimal places.
Combined with the text parameter, filter results based on the title only or all content properties:
AUTO: initially filter results based on titles. If no results are found, extend the search to include other content properties.NO: filter results based on titles only.YES: filter results based on all content properties.
Combined with the text parameter, filter results based on the Accept-Language header value or all languages:
AUTO: initially filter results based on theAccept-Languageheader value. If no results are found, extend the search to include all languages.NO: filter results based on theAccept-Languageheader value.YES: filter results based on all languages.
Filter results to activities which use at least one of the specified features.
Filter activities to those which use at least one of the specified flavours.
Flavours are available from the GET /flavours endpoint.
Filter activities to exclude those which use any of the specified flavours.
Flavours are available from the GET /flavours endpoint.
Change the "fuzziness" level for the text parameter value. Higher levels are less strict about exact text matches.
Include specified statistics about activities matching the query. Results appear in the facets property in the response.
Every facet contains details which can be used to modify the /activities query parameters further.
Most facets contain a breakdown of the number of activities which use that value. These numbers account for all activities which match the query, not just those in the response. When querying for prices, facet values contain the relevant price value instead.
Valid parameter values provide:
available_language: up to ten languagescategory: up to ten categoriescategories_tree: all categories in their tree structurecity: up to ten citiescountry: up to 1000 countriesduration: a breakdown of activity durations:- Up to 2 hours
- 2-4 hours
- 4-8 hours
- 8-24 hours
- Over 24 hours
feature: up to 10 featureshotel: deprecated, usepickuporhotel_pickupinsteadhotel_pickup: up to 1000 pickup points (typeHOTEL)meeting_point_pickup: up to 1000 pickup points (typePICKUP)pickup: up to 1000 pickup points (of any type)price: lowest and highest pricesseller: up to 10 seller gatewaysservice: up to 10 servicesvertical: up to 10 verticalsvertical_categories: up to 10 verticals
Exclude the first N results from the response, where N is the specified integer value.
Filter results to activities which use at least one of the specified pickups.
A numeric value to increase the boost for activities whose seller gateway matches the preferred_seller_code parameter.
Activities connected to the specified seller gateway are "boosted" - treated as if they have a higher relevance value. When sorting by -relevance (from highest to lowest), these activities are more likely to appear first.
Filter results to activities which use any of the specified seller gateways.
Change how the text parameter filters results when multiple words are used:
AND: results must contain all the key words.AUTO: filters byANDfirst. If there are no results, extend to includeORresults.OR: results must contain at least one of the key words.
Filter results to activities which use at least one of the specified services.
Sort results by one or more criteria.
Results are sorted from lowest to highest value by default. To sort from highest to lowest, add - in front of the value.
Sorting by distance requires the coordinates parameter.
Filter results based on their temporary property:
NO: return results with a temporary value offalse.YES: return results with a temporary value oftrue.
Filter results to activities which are connected to at least one of the specified venues.
If set to ALL, if all of the stop words have been removed, search will be performed, if set to 'NONE' will not
The value of this parameter might affect the language of the content in the response, provided a translation in the requested language is available.
A partner's application value, used for analyzing API usage and to identify areas of improvement.
A valid currency code from the /currencies endpoint. Default value may vary depending on the X-Musement-Market header value.
Musement markets contain a modified catalog of activities and prices. Partners are expected to use their assigned market code to view their customized catalog.
An invalid X-Musement-Market value will return a 400 status code response.
The API version to use for the request.
When absent, the latest version is used by default, however the latest version may not be stable. Partners are encouraged to use the latest stable version: 3.4.0.
- Mock serverhttps://partner-api.musement.com/_mock/reference/openapi/activities
- Sandbox serverhttps://sandbox.musement.com/api/v3/activities
- Production serverhttps://api.musement.com/api/v3/activities
- curl
- C#
- Node.js
curl -i -X GET \
'https://partner-api.musement.com/_mock/reference/openapi/activities?available_from=2019-08-24&available_language_in=en%2Cit&available_to=2019-08-24&category_in=new-activities&city_in=0&coordinates=45.7386%2C-9.3641&country_in=IT%2CUS&default_price_range=0%2C34.23&distance=5KM&discounted=NO&duration_range=2%2C8&extend_content_fields=AUTO&extend_other_languages=AUTO&feature_in=free%2Cskip&flavour_in=0&flavour_not_in=0&fuzziness_level=AUTO&include_facets=feature%2Cservice&limit=10&offset=0&pickup_in=497f6eca-6276-4993-bfeb-53cbbbba6f08&preferred_seller_boost=1000&preferred_seller_code=Direct&seller_in=Direct&text=string&text_operator=AND&service_in=pick-up%2Cpet-friendly&sort_by=price%2C-rating&temporary=NO&venue_in=0&zero_terms_query=NONE&vertical_in=sightseeing' \
-H 'Accept-Language: en-US' \
-H 'X-Musement-Application: string' \
-H 'X-Musement-Currency: USD' \
-H 'X-Musement-Market: us' \
-H 'X-Musement-Version: 3.4.0'Activities
Activities which match the query.
The main description of the activity. Does not contain HTML. Translated based on the Accept-Language header value.
The main description of the activity in HTML. Translated based on the Accept-Language header value.
The main description of the activity in the Markdown markup language. Translated based on the Accept-Language header value.
Whether any of the content in the response was machine translated or not.
Musement offers the cheapest price available for this activity compared to major competitors.
Describes the reservation flow for the activity:
CALENDAR-NO-TIMESLOTS: Show calendar with dates, but no timeslots.CALENDAR-TIMESLOTS: Show calendar with dates and timeslots.NO-CALENDAR-FIXED-END: Don't show calendar or timeslots. Purchases are valid until a specific date.NO-CALENDAR-FIXED-VALIDITY: Don't show calendar or timeslots. Purchases are valid for a specific number of days.
This property affects activities connected to packages. A voucher is issued for each multiple of the property value.
The categories the activity belongs to.
The lowest price for child options. Only appears for activities connected to certain integrations.
The URL for the activity's cover image.
A time range which will always be unavailable. Dates that fall within the time range do not appear in the /activities/{activityUuid}/dates endpoint.
Values follow the ISO 8601 standard.
When the booking_type property is CALENDAR-NO-TIMESLOTS, the daily property will be true. Ignore this property for all other booking_type values.
Same as the meta_description property.
A discount percentage that might be applied to some (or all) prices in the activity.
A general overview of how long a customer's experience with an activity will last. The min and max properties are both optional. Their presence changes the meaning of the duration:
- When the
minandmaxare both present and equal, this is a single period of time. Example: Lasts 2 hours - When
minandmaxare both present, but different, the activity spans a range of time. Example: Lasts 1 to 2 hours - When
minis absent and `max is present, the minimum duration is unknown. Example: Lasts up to 2 hours - When
minis present andmaxis absent, the maximum duration is unknown. Example: Lasts at least 1 hour - When either
minormaxhas a value ofP0D, the duration cannot be well-defined. Example: Flexible
When the entire duration_range property is absent, use the validity property instead.
When customers are lost or running late, they can use the information in this property to contact the activity provider for help finding the meeting point. Does not contain HTML. Translated based on the Accept-Language header value.
A list of features for the activity and/or reservation flow.
A list of tags about some of the activity's characteristics.
When true, the activity will offer a 100% refund for certin cancellations. Use the /activities/{activityUuid}/refund-policies endpoint for more details.
Whether the activity can be given as a gift on musement.com or not.
The number of green fee days included for activities that take place at golf courses.
The activity is able to accommodate groups of the listed sizes.
Whether the activity requires extra customer data or not.
Whether the activity requires participant info or not.
When true, dates in the /activities/{activityUuid}/dates endpoint will include price information.
A list of useful selling points for the activity. Does not contain HTML. Does not include taxonomies. Translated based on the Accept-Language header value.
A list of inclusions. Does not contain HTML. Does not include taxonomies. Translated based on the Accept-Language header value.
The number of nights at a hotel that the activity includes.
Additional information about the activity, such as security or weather considerations. Contains HTML. Translated based on the Accept-Language header value.
Whether it is possible to reserve the activity for tomorrow or not.
The activity is able to accommodate people who speak any of the languages in this property. It is not necessarily required to select one of these languages during the reservation flow.
The activity has limited availability and is likely to completely sell out soon.
The activity is popular and has limited availability. Closer dates are likely to sell out quickly.
The maximum amount of time an activity provider needs to process a reservation request. Values follow the ISO 8601 standard.
This property is not used for instant confirmation activities.
Additional details about where customers will start the activity. Does not contain HTML. Translated based on the Accept-Language header value.
Additional details about where customers will start the activity in HTML. Translated based on the Accept-Language header value.
Additional details about where customers will start the activity in the Markdown markup language. Translated based on the Accept-Language header value.
The price for partners based on commercial agreements. Appears for authenticated requests.
An SEO-friendly description of the activity. Does not contain HTML. Translated based on the Accept-Language header value.
An SEO-friendly version of the activity title to use for search results. Does not contain HTML. Translated based on the Accept-Language header value.
When true, the activity provider must manually review and confirm (or refuse) each reservation. When this is the case, the activity is not instant confirmation.
A list of exclusions. Does not contain HTML. Does not include taxonomies. Translated based on the Accept-Language header value.
When true, affects the min_buy parameter in the /activities/{activityUuid}/dates/{date} endpoint for select seller gateways.
When true, the activity booking_type property has a value of NO-CALENDAR-FIXED-END or NO-CALENDAR-FIXED-VALIDITY.
A short summary of which days the activity is available. Contains HTML. Translated based on the Accept-Language header value.
Determines if pickups are a required part of the reservation flow. Value is an array with a single item, one of the following values:
tours-and-activities: Pickups are not part of the reservation flow.tours-and-activities-with-pickup: Customers must select a pickup point for a reservation.
The base price with a service fee, but no discount.
The base price with a discount, but no service fee.
This is the default property used to sort activities, typically from highest to lowest.
This property is used to sort activities by their venue, typically from highest to lowest.
The final price for customers.
The base price with a discount, but no service fee.
A breakdown of the number of reviews for the activity using a "five star" rating system, where a value of 0 is poor and a value of 5 is excellent.
The overall rating for this activity based on the reviews.
An extra fee to add to the base price to cover additional costs for creating a reservation.
A list of customer-friendly services included in the activity.
An automatically generated URL-friendly slug based on the title property.
A combination of the slug property and the activity's numeric ID. This property is used for generating URLs for activities on musement.com.
The publication state of the activity and whether it is available for purchase
The typical publication flow follows:
DRAFT: The activity is being configured and is not available for purchase.REVIEW: The activity is being reviewed before publication and is not available for purchase yet.ONLINE: The activity has been published and is ready for purchase.
The status of an ONLINE activity can change when an activity is no longer available. It can change to either of the following statuses:
ARCHIVEDUNAVAILABLE
An activity that is not available may return to a status of ONLINE again.
Information about the activity provider.
The original currency the activity prices were loaded in, using a currency code from the /currencies endpoint.
When an activity includes a particular attraction, this property indicates if entry to the attraction is included in the final price or not.
The activity title, translated based on the Accept-Language header value.
Whether the content in the response is a translation for the Accept-Language header value or not.
When the duration_range property is absent, this property indicates the maximum period of time the activity is valid for a customer once they start. Value follows the ISO 8601 standard.
When the property has a value of P0D, the activity does not have a well-defined length of time.
A list of venues the activity belongs to.
This property specifies if customers how customers need to present their vouchers to access a reserved activity:
- MOBILE: Vouchers on smartphones or tablets are accepted. Printed vouchers are also accepted.
- PRINTED: Vouchers must be printed. Vouchers on smartphones or tables are not accepted.
- MIXED: Voucher requirements vary depending on the selected product.
When an activity includes vouchers from activity providers, this property indicates whether customers must also receive a copy of the standard Musement voucher or not.
A street address for the location of the activity. Contains HTML. Translated based on the Accept-Language header value.
The duration of the activity, following the ISO 8601 standard.
Use the duration_range property instead.
General information on who can take advantage of reduced rates for the activity. Contains HTML. Translated based on the Accept-Language header value.
The integration which handles the reservation flow.
An automatically generated URL for the activity based on the activity properties and X-Musement-Market header value. The property value may consist of a single hashtag when no URL can be generated.
A list of verticals the activity belongs to. Since this property is deprecated, partners are expected to use categories instead.
Information related to delays or security concerns. Contains HTML. Translated based on the Accept-Language header value.
A breakdown of characteristics for the activities which match the query, based on the facets requested in the include_facets query parameter.
Additional information about the query results. This always contains the count property by default.
When the city_in, country_in or venue_in parameters are used, the meta property contains information about entities that match the parameter values. When more than one of these parameters is used, only one is displayed following this preferred order:
venue_incity_incountry_in
If a parameter value does not correspond to an existing entity, it is excluded from the match results.
The total number of activities in the catalog which match the query parameters.
The entity represented by the match_names and match_ids properties.
The names of the entities which match the query parameter values. These names will be translated based on the Accept-Language header value.
{ "data": [ { … } ], "facets": [ { … } ], "meta": { "count": 150, "match_ids": [ … ], "match_names": [ … ], "match_type": "cities" } }
The value of this parameter might affect the language of the content in the response, provided a translation in the requested language is available.
A partner's application value, used for analyzing API usage and to identify areas of improvement.
A valid currency code from the /currencies endpoint. Default value may vary depending on the X-Musement-Market header value.
Musement markets contain a modified catalog of activities and prices. Partners are expected to use their assigned market code to view their customized catalog.
An invalid X-Musement-Market value will return a 400 status code response.
The API version to use for the request.
When absent, the latest version is used by default, however the latest version may not be stable. Partners are encouraged to use the latest stable version: 3.4.0.
- Mock serverhttps://partner-api.musement.com/_mock/reference/openapi/activities/{activityUuid}
- Sandbox serverhttps://sandbox.musement.com/api/v3/activities/{activityUuid}
- Production serverhttps://api.musement.com/api/v3/activities/{activityUuid}
- curl
- C#
- Node.js
curl -i -X GET \
'https://partner-api.musement.com/_mock/reference/openapi/activities/{activityUuid}' \
-H 'Accept-Language: en-US' \
-H 'X-Musement-Application: string' \
-H 'X-Musement-Currency: USD' \
-H 'X-Musement-Market: us' \
-H 'X-Musement-Version: 3.4.0'Activity
The main description of the activity. Does not contain HTML. Translated based on the Accept-Language header value.
The main description of the activity in HTML. Translated based on the Accept-Language header value.
The main description of the activity in the Markdown markup language. Translated based on the Accept-Language header value.
Whether any of the content in the response was machine translated or not.
Musement offers the cheapest price available for this activity compared to major competitors.
Describes the reservation flow for the activity:
CALENDAR-NO-TIMESLOTS: Show calendar with dates, but no timeslots.CALENDAR-TIMESLOTS: Show calendar with dates and timeslots.NO-CALENDAR-FIXED-END: Don't show calendar or timeslots. Purchases are valid until a specific date.NO-CALENDAR-FIXED-VALIDITY: Don't show calendar or timeslots. Purchases are valid for a specific number of days.
This property affects activities connected to packages. A voucher is issued for each multiple of the property value.
The categories the activity belongs to.
The lowest price for child options. Only appears for activities connected to certain integrations.
The URL for the activity's cover image.
A time range which will always be unavailable. Dates that fall within the time range do not appear in the /activities/{activityUuid}/dates endpoint.
Values follow the ISO 8601 standard.
When the booking_type property is CALENDAR-NO-TIMESLOTS, the daily property will be true. Ignore this property for all other booking_type values.
Same as the meta_description property.
A discount percentage that might be applied to some (or all) prices in the activity.
A general overview of how long a customer's experience with an activity will last. The min and max properties are both optional. Their presence changes the meaning of the duration:
- When the
minandmaxare both present and equal, this is a single period of time. Example: Lasts 2 hours - When
minandmaxare both present, but different, the activity spans a range of time. Example: Lasts 1 to 2 hours - When
minis absent and `max is present, the minimum duration is unknown. Example: Lasts up to 2 hours - When
minis present andmaxis absent, the maximum duration is unknown. Example: Lasts at least 1 hour - When either
minormaxhas a value ofP0D, the duration cannot be well-defined. Example: Flexible
When the entire duration_range property is absent, use the validity property instead.
When customers are lost or running late, they can use the information in this property to contact the activity provider for help finding the meeting point. Does not contain HTML. Translated based on the Accept-Language header value.
A list of features for the activity and/or reservation flow.
A list of tags about some of the activity's characteristics.
When true, the activity will offer a 100% refund for certin cancellations. Use the /activities/{activityUuid}/refund-policies endpoint for more details.
The number of green fee days included for activities that take place at golf courses.
The activity is able to accommodate groups of the listed sizes.
Whether the activity requires extra customer data or not.
Whether the activity requires participant info or not.
When true, dates in the /activities/{activityUuid}/dates endpoint will include price information.
A list of useful selling points for the activity. Does not contain HTML. Does not include taxonomies. Translated based on the Accept-Language header value.
A list of inclusions. Does not contain HTML. Does not include taxonomies. Translated based on the Accept-Language header value.
Additional information about the activity, such as security or weather considerations. Contains HTML. Translated based on the Accept-Language header value.
The activity is able to accommodate people who speak any of the languages in this property. It is not necessarily required to select one of these languages during the reservation flow.
The activity is popular and has limited availability. Closer dates are likely to sell out quickly.
The maximum amount of time an activity provider needs to process a reservation request. Values follow the ISO 8601 standard.
This property is not used for instant confirmation activities.
Additional details about where customers will start the activity. Does not contain HTML. Translated based on the Accept-Language header value.
Additional details about where customers will start the activity in HTML. Translated based on the Accept-Language header value.
Additional details about where customers will start the activity in the Markdown markup language. Translated based on the Accept-Language header value.
The price for partners based on commercial agreements. Appears for authenticated requests.
An SEO-friendly description of the activity. Does not contain HTML. Translated based on the Accept-Language header value.
An SEO-friendly version of the activity title to use for search results. Does not contain HTML. Translated based on the Accept-Language header value.
When true, the activity provider must manually review and confirm (or refuse) each reservation. When this is the case, the activity is not instant confirmation.
A list of exclusions. Does not contain HTML. Does not include taxonomies. Translated based on the Accept-Language header value.
When true, affects the min_buy parameter in the /activities/{activityUuid}/dates/{date} endpoint for select seller gateways.
When true, the activity booking_type property has a value of NO-CALENDAR-FIXED-END or NO-CALENDAR-FIXED-VALIDITY.
A short summary of which days the activity is available. Contains HTML. Translated based on the Accept-Language header value.
Determines if pickups are a required part of the reservation flow. Value is an array with a single item, one of the following values:
tours-and-activities: Pickups are not part of the reservation flow.tours-and-activities-with-pickup: Customers must select a pickup point for a reservation.
The base price with a service fee, but no discount.
The base price with a discount, but no service fee.
This is the default property used to sort activities, typically from highest to lowest.
This property is used to sort activities by their venue, typically from highest to lowest.
The final price for customers.
The base price with a discount, but no service fee.
A breakdown of the number of reviews for the activity using a "five star" rating system, where a value of 0 is poor and a value of 5 is excellent.
An extra fee to add to the base price to cover additional costs for creating a reservation.
A list of customer-friendly services included in the activity.
An automatically generated URL-friendly slug based on the title property.
A combination of the slug property and the activity's numeric ID. This property is used for generating URLs for activities on musement.com.
The publication state of the activity and whether it is available for purchase
The typical publication flow follows:
DRAFT: The activity is being configured and is not available for purchase.REVIEW: The activity is being reviewed before publication and is not available for purchase yet.ONLINE: The activity has been published and is ready for purchase.
The status of an ONLINE activity can change when an activity is no longer available. It can change to either of the following statuses:
ARCHIVEDUNAVAILABLE
An activity that is not available may return to a status of ONLINE again.
Information about the activity provider.
The original currency the activity prices were loaded in, using a currency code from the /currencies endpoint.
When an activity includes a particular attraction, this property indicates if entry to the attraction is included in the final price or not.
The activity title, translated based on the Accept-Language header value.
Whether the content in the response is a translation for the Accept-Language header value or not.
When the duration_range property is absent, this property indicates the maximum period of time the activity is valid for a customer once they start. Value follows the ISO 8601 standard.
When the property has a value of P0D, the activity does not have a well-defined length of time.
A list of venues the activity belongs to.
This property specifies if customers how customers need to present their vouchers to access a reserved activity:
- MOBILE: Vouchers on smartphones or tablets are accepted. Printed vouchers are also accepted.
- PRINTED: Vouchers must be printed. Vouchers on smartphones or tables are not accepted.
- MIXED: Voucher requirements vary depending on the selected product.
When an activity includes vouchers from activity providers, this property indicates whether customers must also receive a copy of the standard Musement voucher or not.
A street address for the location of the activity. Contains HTML. Translated based on the Accept-Language header value.
The duration of the activity, following the ISO 8601 standard.
Use the duration_range property instead.
General information on who can take advantage of reduced rates for the activity. Contains HTML. Translated based on the Accept-Language header value.
The integration which handles the reservation flow.
An automatically generated URL for the activity based on the activity properties and X-Musement-Market header value. The property value may consist of a single hashtag when no URL can be generated.
A list of verticals the activity belongs to. Since this property is deprecated, partners are expected to use categories instead.
Information related to delays or security concerns. Contains HTML. Translated based on the Accept-Language header value.
{ "about": "Join this exclusive tour to discover one of the most iconic works ever: Leonardo da Vinci's Last Supper.You will meet your expert guide in Piazza Santa Maria delle Grazie, where you will begin the tour with a brief explanation.Afterward, thanks to your skip-the-line ticket, you'll go inside straight away without having to wait at the entrance so you can be united with one of the most admired paintings in the world, created by one of the greatest geniuses that ever existed.Here your guide will continue to unravel all the mysteries behind this artwork. What's ironic about the location of the painting? How come The Last Supper isn't a fresco? What happened to the eyes of some characters? How is the painting structured? What do the conspiracy theories say? How do we recognize the genius of Leonardo da Vinci?You will find all the answers to these questions and many others on this unmissable tour!", "about_html": "<p>Join this exclusive tour to discover one of the most iconic works ever: Leonardo da Vinci's Last Supper.</p><p>You will meet your expert guide in Piazza Santa Maria delle Grazie, where you will begin the tour with a brief explanation.</p><p>Afterward, thanks to your skip-the-line ticket, you'll go inside straight away without having to wait at the entrance so you can be united with one of the most admired paintings in the world, created by one of the greatest geniuses that ever existed.</p><p>Here your guide will continue to unravel all the mysteries behind this artwork. What's ironic about the location of the painting? How come The Last Supper isn't a fresco? What happened to the eyes of some characters? How is the painting structured? What do the conspiracy theories say? How do we recognize the genius of Leonardo da Vinci?</p><p>You will find all the answers to these questions and many others on this unmissable tour!</p>", "about_markdown": "Join this exclusive tour to discover one of the most iconic works ever: Leonardo da Vinci's Last Supper.\n\nYou will meet your expert guide in Piazza Santa Maria delle Grazie, where you will begin the tour with a brief explanation.\n\nAfterward, thanks to your skip-the-line ticket, you'll go inside straight away without having to wait at the entrance so you can be united with one of the most admired paintings in the world, created by one of the greatest geniuses that ever existed.\n\nHere your guide will continue to unravel all the mysteries behind this artwork. What's ironic about the location of the painting? How come The Last Supper isn't a fresco? What happened to the eyes of some characters? How is the painting structured? What do the conspiracy theories say? How do we recognize the genius of Leonardo da Vinci?\n\nYou will find all the answers to these questions and many others on this unmissable tour!", "automatically_translated": false, "best_price": false, "booking_type": "CALENDAR-TIMESLOTS", "buy_multiplier": 1, "categories": [ { … } ], "city": { "code": "milan", "content": "Top 6 things to do in MilanFashion paradise, design haven and the epitome of old-school elegance, Milan is a city with many faces. And discovering them is all part of its charm. Known for seamlessly combining both the historic and the on-trend, it's a place where haughty couture and chic dining goes hand-in-hand with magnificent palazzos, ancient churches and early Renaissance art. With so much to dazzle you, we've made it easier by selecting some of our all-time favorites. From gazing awe-struck at Da Vinci's magnificent Last Supper, to admiring the Old Masters at the Pinacoteca or enjoying a night at the city's world-famous opera house, we show you how to make the most of your trip to one of Italy's most cosmopolitan cities.1. The Last Supper Nothing compares to seeing one of Da Vinci's greatest works in the flesh (so to speak). Faded and fragile, partly due to Da Vinci experimenting with an unusual mix of oil and tempera, it's still a staggering work. Not least because of its striking composition and perspective, light years ahead of its time.2. The Duomo Six hundred years in the making, this epic white-marbled cathedral is not to be missed. Brimming with over a hundred spires and 3400 statues, it's the city's most elaborate symbol. Equally impressive is the interior with its enormous stained glass windows, while the rooftop offers spectacular views.3. PinacotecaImmerse yourself in the Old Masters, such as Titian, Tintoretto and Veronese to name a few. Our top highlights include Mantegna's Lamentation over the Dead Christ with its fantastic perspective and brutal realism, along with The Kiss by Francesco Hayez, a passionate symbol of Italy's unification.4. Galleria Vittorio Emanuele IIWith its glorious high arches of glass and steel, and marbled mosaic floors, the Galleria makes for an atmospheric stroll at any time of day. One of the world's oldest shopping arcades, it's also an ideal stop for high-end boutiques, with plenty of fancy dining options if you happen to get hungry.5. La ScalaA night at the opera reaches new heights when it's at La Scala. One of the world's famed opera houses, its stage has been graced by the likes of Maria Callas while Verdi built his impressive reputation here. For non-opera fans, there's also ballet and classical music performances, along with theater tours.6. Da Vinci's VineyardMany don't know that while Da Vinci was painting the Last Supper, he was also tending to his nearby vineyard. Gifted to him by Duke Ludovico Sforza in 1498, it's since been painstakingly recreated so not only can you saunter through the vines as Da Vinci might have done, you can also sip the same wine.Planning your Milan visitWhen to go?Milan is always a good idea, regardless of the month or season. In spring the weather is sunny and mild, while the city buzzes with international events such as Salone del Mobile and Fashion Week. Summer is also popular although it tends to get hot and humid, and the mosquitoes come out in droves. Locals flee the city, especially on the weekends, so it can be nice because the city feels a little less packed. Keep in mind though that come August and shops and restaurants outside of the center are likely to be closed or have summer trading hours. Autumn is ideal for the moderate weather and fewer tourists, while during the winter months you'll get to enjoy the Christmas markets, opera season at La Scala and January sales.How to get there?The city is serviced by three airports. The Malpensa Airport is the main airport for international flights. From here to the city center it's a 50-minute shuttle bus or train ride (via the Malpensa Express; €13 one way). By taxi it will cost €90 fixed fare. The Linate airport is more centrally located and serves mainly domestic flights and those from within the EU. Coaches or public buses (No. 73) are a 30-minute ride to the center, while taxis cost around €20 to €30. The Bergamo airport (Orio al Serio) is used mostly by budget airlines and is a 1-hour bus ride (€8 one way) from central Milan.How many days should you spend?Milan is a city that can be explored over both a weekend, a week, or even a month. In 48 hours you'll be able to experience all its main sights, from Leonardo's Last Supper to a night at La Scala, but keep in mind you'll have to plan in advance for most tickets. Instead, if you want to really immerse yourself in the city, we recommend you taking a little more time. Not only will you be able to shop the world-famed Quadrilatero d'Oro and wander the picturesque Navigli (canals), this will also give you time to get into the rhythm of the city and enjoy local delights, like a classic aperitivo.How to move around the city?The ATM runs the metro, bus and tram services. You'll be able to get to most places via the metro, which has four underground lines (a fifth is projected for the near future): red M1, green M2, yellow M3, and lilac M5. There's also the suburban rail network (the Passante Ferroviario), although it runs much less frequently. A single ticket costs €2; it's valid either for one metro ride or 90 minutes of travel on buses and trams. Other ticket options include a 10-trip carnet (€18) or 3-day ticket (€12).Where to shop?Milan is renowned for shopping and there's no shortage of high-end boutiques and classy consumer goods to swoon over. The Quadrilatero d'Oro is the city's acclaimed shopping district. Framed by four streets - Via Monte Napoleone, Via Sant'Andrea, Via Senato and Via Manzoni - within is a back-to-back line-up of stores by fashion power brands, such as Gucci, Versace, Prada etc. You'll find many of the same brands in the city's main shopping center, Rinascente, right next to the Duomo. Otherwise, if you're looking for something a little less glam, Via Torino has more mainstream brands such as H&M and Zara. Those interested in vintage and alternative clothing need look no further than the hip Ticinese area.", "country": { … }, "cover_image_url": "https://images.musement.com/cover/0002/39/milan-vittorio-emanuele-ii-gallery-italy-jpg_header-138313.jpeg", "headline": "Things to do in Milan: tours and activities", "id": 1, "latitude": 45.459, "longitude": 9.183, "meta_description": "Discover Milan and book tickets to the best tours, attractions, and activities. Admire the Duomo of Milan, visit Leonardo's Last Supper or go on a city walking tour.", "meta_title": "Things to do in Milan: Attractions, tours, and activities", "name": "Milan", "slug": "milan", "time_zone": "Europe/Rome", "top": false, "url": "https://www.musement.com/us/milan/", "weight": 11 }, "cover_image_url": "https://images.musement.com/cover/0001/10/da-vinci-s-last-supper-skip-the-line-tickets-and-guided-tour_header-9730.jpeg?w=540", "cutoff_time": "P2D", "daily": false, "description": "Buy your skip-the-line tickets for the Last Supper in Milan. Enjoy a guided tour and discover the mysteries hidden behind one of the most important works ever!", "discount": 0, "duration_range": { "max": "PT45M" }, "exclusive": false, "features": [ { … }, { … }, { … }, { … } ], "flavours": [ { … }, { … } ], "food": [], "free_cancellation": true, "giftable": true, "giftcard": false, "group_size": [ { … } ], "has_multiple_options": false, "has_price_info_on_date": true, "highlights": [ "Admire Leonardo da Vinci's Last Supper", "Enter quickly by skipping the line at the entrance", "Discover the wonders and mysteries hidden behind this work of art" ], "included": [ "Exclusive English or Italian-speaking Musement guide", "Skip-the-line entrance to Leonardo da Vinci's Last Supper" ], "info": "<ul><li>The venue requires us to provide the name and surname of each visitor; this information is mandatory for purchasing the ticket and for entering the Last Supper. If this requirement isn't met, it will not be possible to enter the venue. The name given at the time of booking must correspond to the name on the participant's passport or identity card. Tickets are nominal and cannot be changed once the booking is completed. Each participant must bring with him/her an identity document</li><li>Due to the rules imposed by the supervisor of cultural artifacts for the city of Milan, your visit to the Last Supper cannot exceed 15 minutes</li><li>Dress code: shoulders and knees must be covered and men should wear full-length trousers</li><li>No liquids, including water bottles, are allowed inside the site</li><li>Large bags/backpacks/suitcases are not permitted inside the Last Supper (only very small bags are allowed). There are no cloakrooms for storing these items but there are free lockers available for small items and bottles</li><li>Photos are not allowed</li><li>The tour is run in small groups</li></ul>", "is_available_today": false, "is_available_tomorrow": false, "languages": [ { … }, { … } ], "latitude": 45.4653785, "longitude": 9.1710985, "last_chance": false, "likely_to_sell_out": false, "max_confirmation_time": "P0D", "meeting_point": "At the corner of Piazza Santa Maria delle Grazie and Corso Magenta - in front of the Vigna di Leonardo Ticket Office, at least 15 minutes before the starting time of the tour.", "meeting_point_html": "<p>At the corner of Piazza Santa Maria delle Grazie and Corso Magenta - in front of the Vigna di Leonardo Ticket Office, at least 15 minutes before the starting time of the tour.</p>", "meeting_point_markdown": "At the corner of Piazza Santa Maria delle Grazie and Corso Magenta - in front of the Vigna di Leonardo Ticket Office, at least 15 minutes before the starting time of the tour.", "meta_description": "Buy your skip-the-line tickets for the Last Supper in Milan. Enjoy a guided tour and discover the mysteries hidden behind one of the most important works ever!", "meta_title": "Skip-the-line tickets and guided tour of the Last Supper", "must_see": false, "needs_voucher": false, "no_index": false, "not_included": [], "numbered_seats": false, "open": false, "order_box_elements": [ "tours-and-activities" ], "original_retail_price": { "currency": "USD", "formatted_iso_value": "$48.00", "formatted_value": "$ 48.00", "value": 48 }, "original_retail_price_without_service_fee": { "currency": "USD", "formatted_iso_value": "$48.00", "formatted_value": "$ 48.00", "value": 48 }, "relevance": 900, "relevance_venue": 10000, "retail_price": { "currency": "USD", "formatted_iso_value": "$48.00", "formatted_value": "$ 48.00", "value": 48 }, "retail_price_without_service_fee": { "currency": "USD", "formatted_iso_value": "$48.00", "formatted_value": "$ 48.00", "value": 48 }, "reviews_aggregated_info": { "0": 1, "1": 5, "2": 13, "3": 154, "4": 1974, "5": 2201 }, "reviews_avg": 4.5, "reviews_number": 4348, "seller_gateway": { "code": "Direct", "name": "Musement Partner" }, "service_fee": { "currency": "USD", "formatted_iso_value": "$0.00", "formatted_value": "$ 0.00", "value": 0 }, "services": [ { … } ], "slug": "da-vinci-s-last-supper-skip-the-line-tickets-and-guided-tour", "slug_id": "da-vinci-s-last-supper-skip-the-line-tickets-and-guided-tour-497", "sold_out": false, "special_offer": false, "status": "ONLINE", "supplier": { "company_name": "Musement - Cenacolo Vinciano", "uuid": "c18dbadd-2044-11e7-9cc9-06a7e332783f" }, "supplier_currency": "EUR", "temporary": false, "ticket": false, "ticket_not_included": false, "title": "Da Vinci's Last Supper skip-the-line tickets and guided tour", "top_seller": true, "translated": true, "url": "https://www.musement.com/us/milan/da-vinci-s-last-supper-skip-the-line-tickets-and-guided-tour-497/", "uuid": "0f548def-2046-11e7-9cc9-06a7e332783f", "validity": "P0D", "venues": [ { … } ], "verticals": [ { … } ], "voucher_access_usage": "MOBILE", "voucher_always_include_ours": false, "where_text": "<p>Corso Magenta, 65/69, 20123 Milan MI, Italy</p><p> </p>" }
Request
Bundles are recommendations of other activities to purchase together with the current activity.
Recommendations are based on activities which are often purchased together by other customers. Sometimes a bundle may contain a promotional discount which can be applied to one or both activities when added to cart.
The value of this parameter might affect the language of the content in the response, provided a translation in the requested language is available.
A partner's application value, used for analyzing API usage and to identify areas of improvement.
A valid currency code from the /currencies endpoint. Default value may vary depending on the X-Musement-Market header value.
Musement markets contain a modified catalog of activities and prices. Partners are expected to use their assigned market code to view their customized catalog.
An invalid X-Musement-Market value will return a 400 status code response.
The API version to use for the request.
When absent, the latest version is used by default, however the latest version may not be stable. Partners are encouraged to use the latest stable version: 3.4.0.
- Mock serverhttps://partner-api.musement.com/_mock/reference/openapi/activities/{activityUuid}/bundles
- Sandbox serverhttps://sandbox.musement.com/api/v3/activities/{activityUuid}/bundles
- Production serverhttps://api.musement.com/api/v3/activities/{activityUuid}/bundles
- curl
- C#
- Node.js
curl -i -X GET \
'https://partner-api.musement.com/_mock/reference/openapi/activities/{activityUuid}/bundles' \
-H 'Accept-Language: en-US' \
-H 'X-Musement-Application: string' \
-H 'X-Musement-Currency: USD' \
-H 'X-Musement-Market: us' \
-H 'X-Musement-Version: 3.4.0'Bundles for activity
Activities which can be bundled with the current activity.
The type of bundle defines how its discount can affect prices:
from_second: the bundle discount only applies to the price of the activity in the bundle.no_discount: the bundle offers no discount.on_everything: the bundle discount applies to the combined price of both activities.
A discount which can be applied based on the discount_type and bundle_type property values.
This property defines how to treat the discount property:
absolute: as a specific currency amount.percentage: as a percentage.
[ { "discount": 0, "discount_type": "percentage", "bundle_type": "no_discount", "rule_id": "247", "activities": [ … ] } ]