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
Limit the maximum number of results to include in the response.
Using a value greater than the maximum is ignored and the maximum number of possible results is used instead.
Exclude the first N results from the response, where N is the specified integer value.
Sort results so that activities which belong to the requested city appear first.
Returns a 400 status code response if the city does not belong to the country.
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/countries/{countryId}/events
- Sandbox serverhttps://sandbox.musement.com/api/v3/countries/{countryId}/events
- Production serverhttps://api.musement.com/api/v3/countries/{countryId}/events
- curl
- C#
- Node.js
curl -i -X GET \
'https://partner-api.musement.com/_mock/reference/openapi/countries/{countryId}/events?limit=10&offset=0&priority_city=1&vertical=1' \
-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'Events in country
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.
General information on dates, times and closures. 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": { … }, "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": { … }, "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": [ … ], "included": [ … ], "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": [ … ], "original_retail_price": { … }, "original_retail_price_without_service_fee": { … }, "relevance": 900, "relevance_venue": 10000, "retail_price": { … }, "retail_price_without_service_fee": { … }, "reviews_aggregated_info": { … }, "reviews_avg": 4.5, "reviews_number": 4348, "seller_gateway": { … }, "service_fee": { … }, "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": { … }, "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>" } ]