Events

A collection of endpoints for events, an older term for activities.

Search eventsDeprecated

Event is an older term for activity.

This endpoint has been replaced by the /activities endpoint.

Request
query Parameters
category_in
Array of integers (Category ID)

Filter results to those which use at least one of the specified categories.

city_in
Array of integers (City ID)

Filter results to those which are connected to at least one of the specified cities.

country_in
Array of integers (Country ID)

Filter results to those which are connected to at least one of the specified countries.

discounted
integer

Filter results based on whether they have discounts or not:

  • 0: return events without discounts.
  • 1: only return events with discounts.
Enum: 0 1
id_in
Array of integers (Event ID)

Filter results to the specified numeric event IDs.

Example: id_in=497,545
limit
number <= 100
Default: 100

Limit the maximum number of results to include in the response.

not_city_in
Array of integers (City ID)

Filter results to those which are not connected to any of the specified cities.

not_country_in
Array of integers (Country ID)

Filter results to those which are not connected to any of the specified countries.

offset
integer >= 0
Default: 0

Exclude the first N results from the response, where N is the specified integer value.

page
integer >= 1
Default: 1

Get the page number of results, based on the limit parameter.

temporary
integer

Filter results based on their temporary property:

  • 0: return results with a temporary value of false.
  • 1: return results with a temporary value of true.
Enum: 0 1
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.

Items Enum: -relevance relevance
Example: sort_by=-relevance
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
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.

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.

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
Responses
200

Events

default

Error

get/events
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/events?category_in=0&city_in=0&country_in=0&discounted=0&id_in=497%2C545&limit=100&not_city_in=0&not_country_in=0&offset=0&page=1&temporary=0&sort_by=-relevance&vertical_in=sightseeing' \
  -H 'Accept-Language: en-US' \
  -H 'X-Musement-Application: string' \
  -H 'X-Musement-Currency: USD' \
  -H 'X-Musement-Market: us' \
  -H 'X-Musement-Version: 3.4.0'
Response samples
application/json
[
  • {
    }
]

Get eventDeprecated

Request
path Parameters
eventId
required
integer

The numeric ID of the event.

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.

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.

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
Responses
200

Event

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

get/events/{eventId}
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/events/{eventId}' \
  -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'
Response samples
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,
  • "city": {
    },
  • "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": "PT45M",
  • "duration_range": {
    },
  • "exclusive": false,
  • "features": [
    ],
  • "flavours": [
    ],
  • "food": [ ],
  • "free_cancellation": true,
  • "giftable": true,
  • "giftcard": false,
  • "group_size": [
    ],
  • "has_extra_customer_data": false,
  • "has_multiple_options": false,
  • "has_passenger_info": true,
  • "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,
  • "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,
  • "saves": 0,
  • "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,
  • "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>"
}

Search comments about eventDeprecated

Comments are an older form of review submitted directly to the Musement platform.

This endpoint has been replaced by the /activities/{activityUuid}/reviews endpoint, which incorporates reviews from various sources.

Request
path Parameters
eventId
required
integer

The numeric ID of the event.

query Parameters
include_empty
string
Default: YES

Include comments in the response with an empty body property.

Enum: NO YES
limit
integer <= 100
Default: 10

Limit the maximum number of results to include in the response.

locale
string (Language code)

Filter results by the locale property.

offset
integer >= 0
Default: 0

Exclude the first N results from the response, where N is the specified integer value.

rating_in
string^\d+(,\d+)*$

Filter comments by their rating property. Providing a single integer returns comments greater than or equal to the value. Providing two integers separated by a comma returns comments with a rating within the specified range.

sort_by
string

Sort comments by one of the following choices:

  • DATE: From least recent sent_at value to most recent.
  • -DATE: From most recent sent_at value to least recent
  • RATING: From lowest rating to highest.
  • -RATING: From highest rating to lowest.
Enum: -DATE -RATING DATE RATING
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.

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
Responses
200

Comments about event

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

get/events/{eventId}/comments
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/events/{eventId}/comments?include_empty=NO&limit=10&locale=string&offset=0&rating_in=string&sort_by=-DATE' \
  -H 'Accept-Language: en-US' \
  -H 'X-Musement-Application: string' \
  -H 'X-Musement-Version: 3.4.0'
Response samples
application/json
[]

Search dates in eventDeprecated

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

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

Request
path Parameters
eventId
required
integer

The numeric ID of the event.

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.

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.

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.

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
Responses
200

Dates for event

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

get/events/{eventId}/dates
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/events/{eventId}/dates?date_from=2019-08-24&date_to=2019-08-24&discounts%5B%5D=10%2C15.5%2C22.05&pickup=497f6eca-6276-4993-bfeb-53cbbbba6f08&tickets_number=0' \
  -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'
Response samples
application/json
[
  • {
    }
]

Get media for eventDeprecated

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

Depending on the event 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 /event/{eventId} endpoint.

Request
path Parameters
eventId
required
integer

The numeric ID of the event.

header Parameters
X-Musement-Application
string (Application value)

A partner's application value, used for analyzing API usage and to identify areas of improvement.

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
Responses
200

Media for event

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

get/events/{eventId}/media
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/events/{eventId}/media' \
  -H 'X-Musement-Application: string' \
  -H 'X-Musement-Version: 3.4.0'
Response samples
application/json
[]

Get events related to eventDeprecated

Returns events that share the same city, country and/or vertical of the specified event, sorted by the relevance property.

Request
path Parameters
eventId
required
integer

The numeric ID of the event.

query Parameters
limit
integer
Default: 6

Limit the maximum number of results to include in the response.

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.

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.

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
Responses
200

Related events

404

Not found: event does not exist or has no related events

default

Error

get/events/{eventId}/related-events
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/events/{eventId}/related-events?limit=6' \
  -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'
Response samples
application/json
[
  • {
    }
]