Activity info

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

Get 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.

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

Activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

get/activities/{activityUuid}
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/activities/{activityUuid}' \
  -H 'Accept-Language: en-US' \
  -H 'X-Musement-Application: string' \
  -H 'X-Musement-Currency: USD' \
  -H 'X-Musement-Market: us' \
  -H 'X-Musement-Version: 3.4.0'
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>"
}

Get cities for activity

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.

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.

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

Cities for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

get/activities/{activityUuid}/destinations
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/activities/{activityUuid}/destinations' \
  -H 'Accept-Language: en-US' \
  -H 'X-Musement-Application: string' \
  -H 'X-Musement-Version: 3.4.0'
Response samples
application/json
[
  • {
    }
]

Get extra customer data schema for activity

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.

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.

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

Extra customer data for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

503

Error

get/activities/{activityUuid}/extra-customer-data/schema
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/activities/{activityUuid}/extra-customer-data/schema' \
  -H 'X-Musement-Application: string' \
  -H 'X-Musement-Version: 3.4.0'
Response samples
application/json
{
  • "title": "form",
  • "type": "object",
  • "properties": {
    },
  • "required": [
    ]
}

Get flavours for activity

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

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.

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

Flavours for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

get/activities/{activityUuid}/flavours
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/activities/{activityUuid}/flavours' \
  -H 'Accept-Language: en-US' \
  -H 'X-Musement-Application: string' \
  -H 'X-Musement-Version: 3.4.0'
Response samples
application/json
[
  • {
    }
]

Get media for activity

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.

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 activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

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

Get languages for activity

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

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.

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

Languages for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

get/activities/{activityUuid}/metadata/languages
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/activities/{activityUuid}/metadata/languages' \
  -H 'X-Musement-Application: string' \
  -H 'X-Musement-Version: 3.4.0'
Response samples
application/json
{
  • "languages": [
    ]
}

Get participant info schema for activity

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.

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.

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

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

503

Error

get/activities/{activityUuid}/participants-info/schema
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/activities/{activityUuid}/participants-info/schema' \
  -H 'Accept-Language: en-US' \
  -H 'X-Musement-Application: string' \
  -H 'X-Musement-Version: 3.4.0'
Response samples
application/json
{
  • "title": "participant",
  • "type": "object",
  • "properties": {
    },
  • "required": [
    ]
}

Get refund policies for activity

Returns an array of refund policies for the activity.

A 404 status code response can mean the activity does not exist or it does not have refund policies. Activities without refund policies are non-refundable.

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.

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

Refund policies for activity

403

Forbidden: activity is not accessible to partners

404

Not found: resource or refund policies do not exist

default

Error

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

Get Covid-19 information for activity

Returns an array of Covid-19 requirements. Only those with an is_active property value of true are in effect for the activity.

Informative descriptions for each item are not provided by this 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.

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

Covid-19 information for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

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

Get taxonomies for activity

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

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.

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

Taxonomies for activity

403

Forbidden: activity is not accessible to partners

404

Not found: activity with UUID does not exist

default

Error

get/activities/{activityUuid}/taxonomies
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/activities/{activityUuid}/taxonomies' \
  -H 'Accept-Language: en-US' \
  -H 'X-Musement-Application: string' \
  -H 'X-Musement-Version: 3.4.0'
Response samples
application/json
[
  • {
    }
]