Activities

Activities can be any tour, attraction or experience that customers can reserve via the Musement API.

Search activities

get/activities

Returns an array of activities and additional meta information.

Request

query Parameters

available_from	string <date> 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.
available_language_in	Array of strings (Language code) Filter activities to those which accommodate at least one of the specified languages. Example: available_language_in=en,it
available_to	string <date> 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.
category_in	Array of strings (Category code) Filter results to those which use at least one of the specified categories. Example: category_in=new-activities
city_in	Array of integers (City ID) Filter results to those which are connected to at least one of the specified cities.
coordinates	string(-)?\d{1,3}(\.\d+)?,(-)?\d{1,3}(\.\d+)? 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. Example: coordinates=45.7386,-9.3641 For more info, check out our guide.
country_in	Array of strings (Country ISO code) Filter results to those which are connected to at least one of the specified countries. Example: country_in=IT,US
default_price_range	string^\d{1,5}(.\d{1,2})?,\d{1,5}(.\d{1,2})?$ 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. Example: default_price_range=0,34.23
discounted	string Filter results by discount: `NO`: return activities without discounts. `YES`: only return activities with discounts. Enum: NO YES
distance	string^\d{1,1000}(KM\|M)$ Filter results to activities located within the specified radius around a pair of coordinates. Parameter must include one of the following units: `KM`: kilometers `M`: miles Must be used together with the `coordinates` parameter. Example: distance=5KM For more info, check out our guide.
duration_range	string^\d{1,5}(.\d{1,2})?(,\d{1,5}(.\d{1,2})?)?$ 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. Example: duration_range=2,8
extend_content_fields	string Default: AUTO 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. Enum: AUTO NO YES
extend_other_languages	string Default: AUTO Combined with the `text` parameter, filter results based on the `Accept-Language` header value or all languages: `AUTO`: initially filter results based on the `Accept-Language` header value. If no results are found, extend the search to include all languages. `NO`: filter results based on the `Accept-Language` header value. `YES`: filter results based on all languages. Enum: AUTO NO YES
feature_in	Array of strings (Feature code) Filter results to activities which use at least one of the specified features. Example: feature_in=free,skip
flavour_in	Array of integers (Flavour ID) Filter activities to those which use at least one of the specified flavours. Flavours are available from the `GET /flavours` endpoint.
flavour_not_in	Array of integers (Flavour ID) Filter activities to exclude those which use any of the specified flavours. Flavours are available from the `GET /flavours` endpoint.
fuzziness_level	string Default: LEVEL-0 Change the "fuzziness" level for the `text` parameter value. Higher levels are less strict about exact text matches. Enum: AUTO LEVEL-0 LEVEL-1 LEVEL-2
include_facets	Array of strings 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 languages `category`: up to ten categories `categories_tree`: all categories in their tree structure `city`: up to ten cities `country`: up to 1000 countries `duration`: 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 features `hotel`: deprecated, use `pickup` or `hotel_pickup` instead `hotel_pickup`: up to 1000 pickup points (type `HOTEL`) `meeting_point_pickup`: up to 1000 pickup points (type `PICKUP`) `pickup`: up to 1000 pickup points (of any type) `price`: lowest and highest prices `seller`: up to 10 seller gateways `service`: up to 10 services `vertical`: up to 10 verticals `vertical_categories`: up to 10 verticals Items Enum: available_language categories_tree category city country duration feature hotel hotel_pickup meeting_point_pickup pickup price seller service venue vertical vertical_categories Example: include_facets=feature,service
limit	integer <= 100 Default: 10 Limit the maximum number of results to include in the response.
offset	integer >= 0 Default: 0 Exclude the first `N` results from the response, where `N` is the specified integer value.
pickup_in	Array of strings <uuid> (Pickup UUID) Filter results to activities which use at least one of the specified pickups.
preferred_seller_boost	integer Default: 1000 A numeric value to increase the boost for activities whose seller gateway matches the `preferred_seller_code` parameter.
preferred_seller_code	string (Seller gateway code) 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. Example: preferred_seller_code=Direct
seller_in	Array of strings (Seller gateway code) Filter results to activities which use any of the specified seller gateways. Example: seller_in=Direct
service_in	Array of strings (Service code) Filter results to activities which use at least one of the specified services. Example: service_in=pick-up,pet-friendly
sort_by	Array of strings 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. Items Enum: -distance -price -rating -relevance -relevance-category -relevance-city -relevance-external -relevance-venue distance price rating relevance relevance-category relevance-city relevance-external relevance-venue Example: sort_by=price,-rating
temporary	string Filter results based on their `temporary` property: `NO`: return results with a temporary value of `false`. `YES`: return results with a temporary value of `true`. Enum: NO YES
text	string Filter results by key words. For more info, check out our guide.
text_operator	string Default: AUTO Change how the `text` parameter filters results when multiple words are used: `AND`: results must contain all the key words. `AUTO`: filters by `AND` first. If there are no results, extend to include `OR` results. `OR`: results must contain at least one of the key words. Enum: AND AUTO OR
venue_in	Array of integers (Venue ID) Filter results to activities which are connected to at least one of the specified venues.
vertical_in	Array of strings (Vertical code) Deprecated Filter results to those which are connected to at least one of the specified verticals. Example: vertical_in=sightseeing
zero_terms_query	string Default: NONE If set to `ALL`, if all of the stop words have been removed, search will be performed, if set to 'NONE' will not Enum: ALL NONE

header Parameters

Accept-Language	string (Language code) Default: en-US The value of this parameter might affect the language of the content in the response, provided a translation in the requested language is available.
X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Currency	string (Currency code) Default: USD A valid currency `code` from the `/currencies` endpoint. Default value may vary depending on the `X-Musement-Market` header value.
X-Musement-Market	string (Musement market) Default: us 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. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Activities

default

Error

Request samples

curl
C#
Node.js

Response samples

200
default

application/json

{"data": [{"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": [{"code": "new-attractions-guided-tours",
"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",
"event_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",
"id": 209,
"level": "1",
"name": "Attractions & guided tours",
"url": "https://www.musement.com/us/milan/attractions-guided-tours-c/"
}
],
"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": {"id": 82,
"iso_code": "IT",
"name": "Italy"
},
"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": [{"code": "musement-tour",
"name": "features.musement-tour"
},
{"code": "istant",
"name": "Instant confirmation"
},
{"code": "skip",
"name": "Skip the line"
},
{"code": "official",
"name": "Official reseller"
}
],
"flavours": [{"active": true,
"id": 111,
"name": "Guided Tour",
"slug": "guided-tour"
},
{"active": true,
"id": 2,
"name": "Entrance Tickets",
"slug": "entrance-tickets"
}
],
"food": [ ],
"free_cancellation": true,
"giftable": true,
"giftcard": false,
"group_size": [{"code": "small",
"name": "Small group"
}
],
"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": [{"code": "en",
"name": "English"
},
{"code": "it",
"name": "Italian"
}
],
"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": [{"code": "dress-code",
"name": "Dress code"
}
],
"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": [{"address": "Milan",
"cover_image_url": "https://images.musement.com/cover/0002/18/leonardo-s-last-supper_header-117602.jpeg",
"description": "The survival of Leonardo's masterpiece is almost as amazing as its vision. It was already being 'restored' in 1726, with an ill-advised application of caustic solvents and varnish. In 1770, Giusseppe Mazza repainted much of the original in oil. In 1853, Stefano Barezzi tried to detach the painting from the wall but failed and instead glued the paint fragments to the base.Only in 1903 was it discovered that the painting was done in tempera, not oil, and its surface was cleaned accordingly. A bomb nearly destroyed the refectory in 1943, but the work was successfully cleaned of mildew and lightened in 1947.Modern restoration showed that the historical over-painting was eating the original and causing it to flake. The decision was therefore made to remove everything added to the mural since it was completed in 1498 - an extremely time-consuming microscopic task using advanced technology. Today, the painting is preserved by an air-filtration system, a monitored environment, and dust-filtering technology. Visitors are limited to 25 people for 15 minutes each time.Opening times\n- 8.15am-6.45pm - Tuesday to Sunday\n- CLOSED: Mondays and public holidays 1 January, 1 May, 25 December\nAbout The Last SupperDuke Ludovico Sforza of Milan was behind the creation of Leonardo da Vinci's masterpiece The Last Supper. The Duke had adopted Santa Maria delle Grazie as his court church and wanted to decorate it in a manner that reflected his wealth and power. This meant a great painting by a great artist.Leonardo began work in 1495 on the northern wall of the refectory and completed the painting three years later, the complete image measuring 15x29ft. Contrary to popular belief, it was not a fresco, which required fast and decisive work before the wet plaster dried. Leonardo liked to take his time and change his mind, so he designed a new kind of application using tempera (an egg-based paint).Alas, the great genius Leonardo made a mistake this time. His base for the painting included pitch and mastic, which did not bond the pigment as well or as permanently as he had hoped. The aesthetic considerations, however, were sublime. Leonardo created his amazing illusions of perspective using a nail in the wall and strings radiating from it to ensure that all would be correctThe subject was a common one in churches, but Leonardo's innovation was to create a sense of drama and movement by portraying the exact moment when Jesus announced that one of his disciples would betray him. What we see is a radiating wave of shocked reaction. He also chose to portray all attendees in a straight line so that each could receive due attention.It's said that the faces in the work are based on real people known to the artist. Judas may have been a real-life local prisoner or criminal and, here, Leonardo puts him among the others rather than separate (as traditional dictated). Judas is the only one who seems not to be outraged or surprised. AddressPiazza Santa Maria delle Grazie 2, Milan Getting there\n- By Metro: Line 1: Conciliazione\n- By tram: Line 16: S Maria delle Grazia",
"headline": "Leonardo Da Vinci's Last Supper tickets and tours",
"id": 393,
"latitude": 45.466091,
"longitude": 9.171187,
"meta_description": "Get your tickets and tours for the Last Supper by Leonardo da Vinci in Milan. Admire one of the world's most famous masterpieces painted by one of the greatest artists!",
"meta_title": "Leonardo Da Vinci's Last Supper Tickets and Tours in Milan",
"name": "Leonardo's Last Supper",
"url": "https://www.musement.com/us/milan/leonardo-s-last-supper-v/"
}
],
"verticals": [{"active": true,
"code": "arts-culture",
"cover_image_url": "https://images.musement.com/vertical/0001/30/art-and-culture_header-29023.jpeg?w=540",
"id": 1,
"meta_description": "From classically beautiful renaissance paintings and sculptures to revolutionary modern artworks, admire world-renowned art with Musement.",
"meta_title": "Discover the remarkable world of Art and Museums",
"name": "Museums & art",
"relevance": 100,
"slug": "museums-art",
"url": "https://www.musement.com/us/museums-art-t/"
}
],
"voucher_access_usage": "MOBILE",
"voucher_always_include_ours": false,
"where_text": "<p>Corso Magenta, 65/69, 20123 Milan MI, Italy</p><p> </p>"
}
],
"facets": [{"facet_type": "RANGE",
"key": "price",
"query_param": "default_price_range",
"label": "Price (per adult)",
"values": [{"key": "min",
"label": "Min",
"value": 10,
"query_value": "10"
},
{"key": "max",
"label": "Max",
"value": 199.99,
"query_value": "199.99"
}
]
}
],
"meta": {"count": 150,
"match_ids": ["1",
"76"
],
"match_names": ["Milan",
"Washington, D.C."
],
"match_type": "cities"
}
}

Get activity

get/activities/{activityUuid}

Returns an activity

Request

path Parameters

activityUuid

required

string <uuid>

The UUID of the activity.

header Parameters

Accept-Language	string (Language code) Default: en-US The value of this parameter might affect the language of the content in the response, provided a translation in the requested language is available.
X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Currency	string (Currency code) Default: USD A valid currency `code` from the `/currencies` endpoint. Default value may vary depending on the `X-Musement-Market` header value.
X-Musement-Market	string (Musement market) Default: us 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. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
default

application/json

{"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": [{"code": "new-attractions-guided-tours",
"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",
"event_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",
"id": 209,
"level": "1",
"name": "Attractions & guided tours",
"url": "https://www.musement.com/us/milan/attractions-guided-tours-c/"
}
],
"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": {"id": 82,
"iso_code": "IT",
"name": "Italy"
},
"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": [{"code": "musement-tour",
"name": "features.musement-tour"
},
{"code": "istant",
"name": "Instant confirmation"
},
{"code": "skip",
"name": "Skip the line"
},
{"code": "official",
"name": "Official reseller"
}
],
"flavours": [{"active": true,
"id": 111,
"name": "Guided Tour",
"slug": "guided-tour"
},
{"active": true,
"id": 2,
"name": "Entrance Tickets",
"slug": "entrance-tickets"
}
],
"food": [ ],
"free_cancellation": true,
"giftable": true,
"giftcard": false,
"group_size": [{"code": "small",
"name": "Small group"
}
],
"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": [{"code": "en",
"name": "English"
},
{"code": "it",
"name": "Italian"
}
],
"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": [{"code": "dress-code",
"name": "Dress code"
}
],
"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": [{"address": "Milan",
"cover_image_url": "https://images.musement.com/cover/0002/18/leonardo-s-last-supper_header-117602.jpeg",
"description": "The survival of Leonardo's masterpiece is almost as amazing as its vision. It was already being 'restored' in 1726, with an ill-advised application of caustic solvents and varnish. In 1770, Giusseppe Mazza repainted much of the original in oil. In 1853, Stefano Barezzi tried to detach the painting from the wall but failed and instead glued the paint fragments to the base.Only in 1903 was it discovered that the painting was done in tempera, not oil, and its surface was cleaned accordingly. A bomb nearly destroyed the refectory in 1943, but the work was successfully cleaned of mildew and lightened in 1947.Modern restoration showed that the historical over-painting was eating the original and causing it to flake. The decision was therefore made to remove everything added to the mural since it was completed in 1498 - an extremely time-consuming microscopic task using advanced technology. Today, the painting is preserved by an air-filtration system, a monitored environment, and dust-filtering technology. Visitors are limited to 25 people for 15 minutes each time.Opening times\n- 8.15am-6.45pm - Tuesday to Sunday\n- CLOSED: Mondays and public holidays 1 January, 1 May, 25 December\nAbout The Last SupperDuke Ludovico Sforza of Milan was behind the creation of Leonardo da Vinci's masterpiece The Last Supper. The Duke had adopted Santa Maria delle Grazie as his court church and wanted to decorate it in a manner that reflected his wealth and power. This meant a great painting by a great artist.Leonardo began work in 1495 on the northern wall of the refectory and completed the painting three years later, the complete image measuring 15x29ft. Contrary to popular belief, it was not a fresco, which required fast and decisive work before the wet plaster dried. Leonardo liked to take his time and change his mind, so he designed a new kind of application using tempera (an egg-based paint).Alas, the great genius Leonardo made a mistake this time. His base for the painting included pitch and mastic, which did not bond the pigment as well or as permanently as he had hoped. The aesthetic considerations, however, were sublime. Leonardo created his amazing illusions of perspective using a nail in the wall and strings radiating from it to ensure that all would be correctThe subject was a common one in churches, but Leonardo's innovation was to create a sense of drama and movement by portraying the exact moment when Jesus announced that one of his disciples would betray him. What we see is a radiating wave of shocked reaction. He also chose to portray all attendees in a straight line so that each could receive due attention.It's said that the faces in the work are based on real people known to the artist. Judas may have been a real-life local prisoner or criminal and, here, Leonardo puts him among the others rather than separate (as traditional dictated). Judas is the only one who seems not to be outraged or surprised. AddressPiazza Santa Maria delle Grazie 2, Milan Getting there\n- By Metro: Line 1: Conciliazione\n- By tram: Line 16: S Maria delle Grazia",
"headline": "Leonardo Da Vinci's Last Supper tickets and tours",
"id": 393,
"latitude": 45.466091,
"longitude": 9.171187,
"meta_description": "Get your tickets and tours for the Last Supper by Leonardo da Vinci in Milan. Admire one of the world's most famous masterpieces painted by one of the greatest artists!",
"meta_title": "Leonardo Da Vinci's Last Supper Tickets and Tours in Milan",
"name": "Leonardo's Last Supper",
"url": "https://www.musement.com/us/milan/leonardo-s-last-supper-v/"
}
],
"verticals": [{"active": true,
"code": "arts-culture",
"cover_image_url": "https://images.musement.com/vertical/0001/30/art-and-culture_header-29023.jpeg?w=540",
"id": 1,
"meta_description": "From classically beautiful renaissance paintings and sculptures to revolutionary modern artworks, admire world-renowned art with Musement.",
"meta_title": "Discover the remarkable world of Art and Museums",
"name": "Museums & art",
"relevance": 100,
"slug": "museums-art",
"url": "https://www.musement.com/us/museums-art-t/"
}
],
"voucher_access_usage": "MOBILE",
"voucher_always_include_ours": false,
"where_text": "<p>Corso Magenta, 65/69, 20123 Milan MI, Italy</p><p> </p>"
}

Get bundles for activity

get/activities/{activityUuid}/bundles

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.

Request

path Parameters

activityUuid

required

string <uuid>

The UUID of the activity.

header Parameters

Accept-Language	string (Language code) Default: en-US The value of this parameter might affect the language of the content in the response, provided a translation in the requested language is available.
X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Currency	string (Currency code) Default: USD A valid currency `code` from the `/currencies` endpoint. Default value may vary depending on the `X-Musement-Market` header value.
X-Musement-Market	string (Musement market) Default: us 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. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Bundles for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity does not exist or it has no bundles

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
default

application/json

[{"discount": 0,
"discount_type": "percentage",
"bundle_type": "no_discount",
"rule_id": "247",
"activities": [{"bundled_price": {"currency": "EUR",
"formatted_iso_value": "€25.00",
"formatted_value": "€ 25.00",
"value": 25
},
"cover_image_url": "https://images-sandbox.musement.com/cover/0001/19/9-11-memorial-museum-tickets_header-18896.jpeg?w=540",
"original_retail_price_without_service_fee": {"currency": "EUR",
"formatted_iso_value": "€25.00",
"formatted_value": "€ 25.00",
"value": 25
},
"original_retail_price": {"currency": "EUR",
"formatted_iso_value": "€25.00",
"formatted_value": "€ 25.00",
"value": 25
},
"retail_price": {"currency": "EUR",
"formatted_iso_value": "€25.00",
"formatted_value": "€ 25.00",
"value": 25
},
"retail_price_without_service_fee": {"currency": "EUR",
"formatted_iso_value": "€25.00",
"formatted_value": "€ 25.00",
"value": 25
},
"reviews_avg": 4.6,
"service_fee": {"currency": "EUR",
"formatted_iso_value": "€0.00",
"formatted_value": "€ 0.00",
"value": 0
},
"title": "9-11 Memorial and Museum tickets",
"uuid": "11471ae8-2046-11e7-9cc9-06a7e332783f"
}
]
}
]

Get translation for activity

get/activities/{activityUuid}/contents/{locale}

Returns a translation (if it exists) for an activity.

Request

path Parameters

activityUuid required	string <uuid> The UUID of the activity.
locale required	string (Language code) [ 2 .. 5 ] characters

header Parameters

X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Translation for activity

404

One of the resources does not exist

default

Error

Request samples

curl
C#
Node.js

Response samples

200
404
default

application/json

{"description": "<p>Join this exclusive tour to discover one of the most iconic works ever: Leonardo da Vinci&#39;s Last Supper.</p>\r\n\r\n<p>You will meet your expert guide in Piazza Santa Maria delle Grazie, where you will begin the tour with a brief explanation.</p>\r\n\r\n<p>Afterward, thanks to your skip-the-line ticket, you&#39;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>\r\n\r\n<p>Here your guide will continue to unravel all the mysteries behind this artwork. What&#39;s ironic about the location of the painting? How come The Last Supper isn&#39;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>\r\n\r\n<p>You will find all the answers to these questions and many others on this unmissable tour!</p>",
"highlights": "<ul>\r\n\t<li>Admire Leonardo da Vinci&#39;s Last Supper</li>\r\n\t<li>Enter quickly&nbsp;by skipping the line at the entrance</li>\r\n\t<li>Discover the wonders and mysteries&nbsp;hidden behind this work of art</li>\r\n</ul>",
"included": "<ul>\r\n\t<li>Exclusive English or Italian-speaking Musement guide</li>\r\n\t<li>Skip-the-line entrance to Leonardo da Vinci&#39;s Last Supper</li>\r\n</ul>",
"info": "<ul>\r\n\t<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&#39;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&#39;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>\r\n\t<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>\r\n\t<li>Dress code: shoulders and knees must be covered and men should wear full-length trousers</li>\r\n\t<li>No liquids,&nbsp;including water bottles, are allowed inside the site</li>\r\n\t<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>\r\n\t<li>Photos are not allowed</li>\r\n\t<li>The tour is run in small groups</li>\r\n</ul>",
"info_voucher": "<ul>\r\n\t<li>Tickets are nominal and cannot be changed once the booking is completed. Shoulders and knees must be covered and men should wear full-length trousers. No liquids,&nbsp;including water bottles, are allowed inside the site. Large bags/backpacks/suitcases are not permitted inside&nbsp;(only very small bags). There are no cloakrooms for storing these items. Free lockers are available for small items and bottles. Photos are not allowed</li>\r\n\t<li>Each participant must bring with him/her an identity document</li>\r\n</ul>",
"is_default": true,
"is_manually_translated_complete": true,
"is_manually_translated_highlights": true,
"is_manually_translated_info_voucher": true,
"is_manually_translated_meeting_point": true,
"is_manually_translated_title": true,
"locale": "us",
"meeting_point": "<p>At the corner of Piazza Santa Maria delle Grazie&nbsp;and Corso Magenta&nbsp;- in front of the Vigna di Leonardo Ticket Office, at least 15 minutes before the starting time of the tour.</p>",
"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",
"slug": "da-vinci-s-last-supper-skip-the-line-tickets-and-guided-tour",
"title": "Da Vinci's Last Supper skip-the-line tickets and guided tour",
"translated": true,
"where": "<p>Corso Magenta, 65/69, 20123 Milan MI, Italy</p>\r\n\r\n<p>&nbsp;</p>"
}

Get country for activity

get/activities/{activityUuid}/country

Returns the country associated with the activity's default city.

Request

path Parameters

activityUuid

required

string <uuid>

The UUID of the activity.

header Parameters

Accept-Language	string (Language code) Default: en-US The value of this parameter might affect the language of the content in the response, provided a translation in the requested language is available.
X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Country for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
default

application/json

{"country_prefix": "+39",
"currency_code": "EUR",
"id": 82,
"iso_code": "IT",
"iso3char": "ITA",
"name": "Italy"
}

Search dates in activity

get/activities/{activityUuid}/dates

Depending on the activity configuration, this endpoint may return price info in addition to dates.

For activities with pickups, the pickup query parameter must be used.

For more info, check out our guide.

Request

path Parameters

activityUuid

required

string <uuid>

The UUID of the activity.

query Parameters

date_from	string <date> Filter results to those which take place on or after the specified date. When absent, today's date is used by default.
date_to	string <date> Filter results to those which take place before the specified date. When absent, a value of roughly one year from today's date is used. The exact default value varies depending on the activity configuration.
discounts[]	Array of numbers <float> Response will contain a `retail_prices_with_custom_discount` property which contains a preview of prices after the specified discounts are applied. Up to two decimal places are permitted. Example: discounts[]=10&discounts[]=15.5&discounts[]=22.05
pickup	string <uuid> (Pickup UUID) Filter dates to those which are available for the specified pickup. Required for activities whose `order_box_elements` property contains `tours-and-activities-with-pickup`. For more info, check out our guide.
tickets_number	integer Filter dates to those which have enough seats available for the specified quantity. Used for activities with select seller gateways.

header Parameters

Accept-Language	string (Language code) Default: en-US The value of this parameter might affect the language of the content in the response, provided a translation in the requested language is available.
X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Currency	string (Currency code) Default: USD A valid currency `code` from the `/currencies` endpoint. Default value may vary depending on the `X-Musement-Market` header value.
X-Musement-Market	string (Musement market) Default: us 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. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Dates for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
default

application/json

[{"day": "1985-11-05",
"discount_amount": {"currency": "USD",
"formatted_value": "$ 10.00",
"formatted_iso_value": "$10.00",
"value": 10
},
"merchant_price": {"currency": "USD",
"formatted_value": "$ 10.00",
"formatted_iso_value": "$10.00",
"value": 10
},
"original_retail_price": {"currency": "USD",
"formatted_value": "$ 10.00",
"formatted_iso_value": "$10.00",
"value": 10
},
"original_retail_price_without_service_fee": {"currency": "USD",
"formatted_value": "$ 10.00",
"formatted_iso_value": "$10.00",
"value": 10
},
"retail_price": {"currency": "USD",
"formatted_value": "$ 10.00",
"formatted_iso_value": "$10.00",
"value": 10
},
"retail_price_without_service_fee": {"currency": "USD",
"formatted_value": "$ 10.00",
"formatted_iso_value": "$10.00",
"value": 10
},
"retail_prices_with_custom_discount": [{"currency": "USD",
"formatted_value": "$ 10.00",
"formatted_iso_value": "$10.00",
"value": 10
}
],
"service_fee": {"currency": "USD",
"formatted_value": "$ 10.00",
"formatted_iso_value": "$10.00",
"value": 10
},
"sold_out": false
}
]

Get schedule for date in activity

get/activities/{activityUuid}/dates/{date}

Returns all options, times, holders, languages and products for the specified date. A product's type and ID, required for adding a product to cart, can be found in the response.

For activities with pickups, the pickup query parameter must be used.

A 422 status code response means the requested date is not available, either temporarily or permanently. Customers are encouraged to try a different date.

For more info, check out our guide.

Request

path Parameters

activityUuid required	string <uuid> The UUID of the activity.
date required	string <date> The specified date.

query Parameters

discounts[]	Array of numbers <float> Response will contain a `retail_prices_with_custom_discount` property which contains a preview of prices after the specified discounts are applied. Up to two decimal places are permitted. Example: discounts[]=10&discounts[]=15.5&discounts[]=22.05
pickup	string <uuid> (Pickup UUID) Filter dates to those which are available for the specified pickup. Required for activities whose `order_box_elements` property contains `tours-and-activities-with-pickup`. For more info, check out our guide.
tickets_number	integer Filter dates to those which have enough seats available for the specified quantity. Used for activities with select seller gateways.

header Parameters

Accept-Language	string (Language code) Default: en-US The value of this parameter might affect the language of the content in the response, provided a translation in the requested language is available.
X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Currency	string (Currency code) Default: USD A valid currency `code` from the `/currencies` endpoint. Default value may vary depending on the `X-Musement-Market` header value.
X-Musement-Market	string (Musement market) Default: us 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. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Schedule for date

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID or date in activity do not exist

422

Unprocessable content: unable to get schedule for activity date

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
422
default

application/json

[{"groups": [{"default": false,
"description": "",
"feature_code": "tour",
"name": "Tour",
"type": "TIME-BASED",
"slots": [{"availability": -1,
"languages": [{"code": "en",
"name": "English"
},
{"code": "it",
"name": "Italian"
}
],
"max_buy": -1,
"min_buy": 1,
"products": [{"activity_uuid": "6520c1d5-3484-4610-9bce-87670cee3ede",
"age_range": "3-17",
"availability": -1,
"default": true,
"discount_amount": {"currency": "USD",
"formatted_value": "$ 0.00",
"formatted_iso_value": "$0.00",
"value": 0
},
"holder_code": "adult",
"holder_code_normalized": "ADULT",
"language_codes": ["en",
"it"
],
"max_buy": 15,
"min_buy": 1,
"name": "Adult",
"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
},
"product_id": "14491063752",
"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
},
"service_fee": {"currency": "USD",
"formatted_value": "$ 0.00",
"formatted_iso_value": "$0.00",
"value": 0
}
}
],
"tags": [ ],
"time": "18:00"
}
]
}
]
}
]

Get cities for activity

get/activities/{activityUuid}/destinations

Every activity has one default city which appears in the /activities and /activities/{activityUuid} endpoints. However, an activity may be connected to multiple cities.

This endpoint lists all connected cities and indicates which one is the default.

For more info, check out our guide.

Request

path Parameters

activityUuid

required

string <uuid>

The UUID of the activity.

header Parameters

Accept-Language	string (Language code) Default: en-US The value of this parameter might affect the language of the content in the response, provided a translation in the requested language is available.
X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Cities for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
default

application/json

[{"id": 76,
"code": "washington dc",
"content": "Often overshadowed by the more flashy New York City, Washington DC represents an essential destination of an East Coast tour. In fact, the District of Columbia is a real must-see for those who want to discover and get in touch with the true essence of American history and culture. Not only a political capital but also an important cultural and artistic center, Washington DC is found between the states of Virginia - on its southwest side - and Maryland - on its southeast, northeast, and northwest sides. The ideal tour of Washington starts from the National Mall, a monumental avenue of about 3 km that runs along the east-west from Capitol Hill to the Lincoln Memorial.",
"content_html": "<p>Often overshadowed by the more flashy New York City, <strong>Washington DC </strong>represents an essential destination of an East Coast tour. In fact, the <strong>District of Columbia</strong> is a real <strong>must-see</strong> for those who want to discover and get in touch with the true essence of American history and culture.</p><p>Not only a <strong>political capital</strong> but also an <strong>important cultural and artistic center</strong>, Washington DC is found between the states of Virginia - on its southwest side - and Maryland - on its southeast, northeast, and northwest sides.</p><p>The ideal tour of Washington starts from the <strong>National Mall</strong>, a monumental avenue of about 3 km that runs along the east-west from <strong>Capitol Hill</strong> to the <strong>Lincoln Memorial</strong>. </p>",
"country": {"id": 184,
"iso_code": "US",
"iso3char": "USA",
"name": "United States of America"
},
"cover_image_url": "https://images-sandbox.musement.com/cover/0001/43/washington_header-42349.jpeg",
"activities_count": 14,
"latitude": 38.918,
"list_count": 0,
"longitude": -77.037,
"meta_description": "Find out what's happening in Washington D.C. and book your tickets for the best museums and operas in advance. Skip the line, make your trip more enjoyable. Museums, opera, classical concerts at your fingertips.",
"more": "",
"name": "Washington DC",
"show_in_popular": false,
"time_zone": "America/New_York",
"top": false,
"url": "https://.sbox.musement.com/us/washington-dc/",
"uuid": "ec1dd48e-339d-11ea-ba3c-029a16533fe4",
"venue_count": 1,
"weight": 2,
"default": true
}
]

Get extra customer data schema for activity

get/activities/{activityUuid}/extra-customer-data/schema

Extra customer data is information requested per reservation. You can use this endpoint for a preview of possible fields that might be used during the reservation flow.

The response follows the JSON Schema Specification to describe the info requested for each participant.

For more info, check out our guide.

Request

path Parameters

activityUuid

required

string <uuid>

The UUID of the activity.

header Parameters

X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Extra customer data for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
default

application/json

{"title": "form",
"type": "object",
"properties": {"property1": {"attr": {"pattern": "string",
"placeholder": "string"
},
"enum": ["string"
],
"enum_titles": ["string"
],
"format": "date",
"propertyOrder": 1,
"title": "string",
"type": "integer"
},
"property2": {"attr": {"pattern": "string",
"placeholder": "string"
},
"enum": ["string"
],
"enum_titles": ["string"
],
"format": "date",
"propertyOrder": 1,
"title": "string",
"type": "integer"
},
"phone_number": {"type": "string",
"title": "Phone number",
"propertyOrder": 1
}
},
"required": ["phone_number"
]
}

Get flavours for activity

get/activities/{activityUuid}/flavours

Flavours are tags which provide additional information about an activity's characteristics.

For more info, check out our guide.

Request

path Parameters

activityUuid

required

string <uuid>

The UUID of the activity.

header Parameters

Accept-Language	string (Language code) Default: en-US The value of this parameter might affect the language of the content in the response, provided a translation in the requested language is available.
X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Flavours for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
default

application/json

[{"active": true,
"id": 0,
"name": "string",
"slug": "string"
}
]

Get translated languages for activity

get/activities/{activityUuid}/languages

This endpoint returns all the languages which have a translation in the activity. When using the Accept-Language header for select activity endpoints, the response contains either the corresponding translation (if available) or the default translation (usually English).

Request

path Parameters

activityUuid

required

string <uuid>

The UUID of the activity.

header Parameters

X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Translated languages for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
default

application/json

[{"code": "us",
"default": true,
"name": "languages.us"
}
]

Get media for activity

get/activities/{activityUuid}/media

The response contains an array of media items for the activity. Items are mainly images, but could also be video.

Depending on the activity configuration, the cover image may or may not be part of the results. If none of the results is the cover image, you can get its URL from the /activities/{activityUuid} endpoint.

Request

path Parameters

activityUuid

required

string <uuid>

The UUID of the activity.

header Parameters

X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Media for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
default

application/json

[{"id": 94516,
"is_cover": false,
"title": "Via Appia at sunset",
"type": "image",
"url": "https://images-sandbox.musement.com/default/0001/95/thumb_94516_default_header.jpeg?w=750&h=500"
}
]

Get merchant tags for activity

get/activities/{activityUuid}/merchant-tags

This endpoint returns a list of merchant tags for an activity. Only merchant tags set up for the authenticated partner using a valid access token are returned.

Some merchant partners request custom tags for activities to better categorize them on their own platform. Partners must define the tags and their criteria with the Strategic partnerships team before Musement can begin assigning tags to activities.

SecurityPartner

Request

path Parameters

activityUuid

required

string <uuid>

The UUID of the activity.

header Parameters

X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Market	string (Musement market) Default: us 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. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Merchant tags for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
default

application/json

["Must have"
]

Get languages for activity

get/activities/{activityUuid}/metadata/languages

Get all languages which may be used for a timeslot in the specified activity.

For more info, check out our guide.

Request

path Parameters

activityUuid

required

string <uuid>

The UUID of the activity.

header Parameters

X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Languages for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
default

application/json

{"languages": ["us"
]
}

Get participant info schema for activity

get/activities/{activityUuid}/participants-info/schema

Participant info is required for each person in a reservation. You can use this endpoint for a preview of possible fields that might be used during the reservation flow.

The response follows the JSON Schema Specification to describe the info requested for each participant.

For more info, check out our guide.

Request

path Parameters

activityUuid

required

string <uuid>

The UUID of the activity.

header Parameters

Accept-Language	string (Language code) Default: en-US The value of this parameter might affect the language of the content in the response, provided a translation in the requested language is available.
X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Participant info for activity

403

Forbidden: activity is not accessible to partners

404

Not found: resource does not exist or it does not require participant info

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
default

application/json

{"title": "participant",
"type": "object",
"properties": {"property1": {"attr": {"pattern": "string",
"placeholder": "string"
},
"enum": ["string"
],
"enum_titles": ["string"
],
"format": "date",
"propertyOrder": 1,
"title": "string",
"type": "integer"
},
"property2": {"attr": {"pattern": "string",
"placeholder": "string"
},
"enum": ["string"
],
"enum_titles": ["string"
],
"format": "date",
"propertyOrder": 1,
"title": "string",
"type": "integer"
},
"firstname": {"type": "string",
"title": "First name",
"propertyOrder": 1
},
"lastname": {"type": "string",
"title": "Last name",
"propertyOrder": 2
}
},
"required": ["firstname",
"lastname"
]
}

Get pickups for activity

get/activities/{activityUuid}/pickups

Some activities require selecting a pickup from this endpoint as part of the reservation flow.

For more info, check out our guide.

Request

path Parameters

activityUuid

required

string <uuid>

The UUID of the activity.

header Parameters

X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Pickups for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
default

application/json

[{"latitude": 39.7191046,
"longitude": 3.4578191,
"name": "Allsun Hotel Lux de Mar",
"tags": [{"id": "AC5257025",
"type": "CONTENT-MANAGER-DATA"
},
{"id": "472",
"type": "HOTEL-CODE"
}
],
"type": "HOTEL",
"uuid": "c2326f61-c0d7-4353-8a1f-c1f12c4249f3"
}
]

Get refund policies for activity

get/activities/{activityUuid}/refund-policies

Returns an array of refund policies for the activity.

Activities without refund policies are non-refundable. Depending on the configuration, an activity without refund policies will return either an empty or array or a 404 status code response.

A 404 status code response could also mean the activity does not exist.

For more info, check out our guide.

Request

path Parameters

activityUuid

required

string <uuid>

The UUID of the activity.

header Parameters

X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Refund policies for activity

403

Forbidden: activity is not accessible to partners

404

Not found: resource or refund policies do not exist

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
default

application/json

[{"period": "P2D",
"type": "PERCENTAGE",
"uuid": "e9d85f7d-6e48-11e8-8a05-02bc4b6113e8",
"value": 100
}
]

Get taxonomies for activity

get/activities/{activityUuid}/taxonomies

Taxonomies provide information about the activity's highlights, inclusions and exclusions.

For more info, check out our guide.

Request

path Parameters

activityUuid

required

string <uuid>

The UUID of the activity.

header Parameters

Accept-Language	string (Language code) Default: en-US The value of this parameter might affect the language of the content in the response, provided a translation in the requested language is available.
X-Musement-Application	string (Application value) A partner's application value, used for analyzing API usage and to identify areas of improvement. For more info, check out our guide.
X-Musement-Version	string^[0-9]+?.[0-9]+?.[0-9]+?$ 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`. Example: 3.4.0 For more info, check out our guide.

Responses

200

Taxonomies for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

Request samples

curl
C#
Node.js

Response samples

200
403
404
default

application/json

[{"category": "FOOD-AND-DRINK",
"name": "Mixed drinks at the bar - lit moves on the floor",
"type": "HIGHLIGHT",
"uuid": "7a1de19f-51e1-11e7-96a2-06d26c7657b2"
}
]