Activity info

A collection of endpoints which can be used to provide information to customers about a specific activity.

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 
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,
  • "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>"
}
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 
Response samples 
application/json
{
  • "country_prefix": "+39",
  • "currency_code": "EUR",
  • "id": 82,
  • "iso_code": "IT",
  • "iso3char": "ITA",
  • "name": "Italy"
}
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 
Response samples 
application/json
[
  • {
    }
]
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 
Response samples 
application/json
{
  • "title": "form",
  • "type": "object",
  • "properties": {
    },
  • "required": [
    ]
}
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 
Response samples 
application/json
[
  • {
    }
]
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 
Response samples 
application/json
[]
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 
Response samples 
application/json
{
  • "languages": [
    ]
}
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 
Response samples 
application/json
{
  • "title": "participant",
  • "type": "object",
  • "properties": {
    },
  • "required": [
    ]
}
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 
Response samples 
application/json
[
  • {
    }
]
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 
Response samples 
application/json
[
  • {
    }
]