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
Download OpenAPI description
Overview
Languages
Servers
Mock server
https://partner-api.musement.com/_mock/reference/openapi
Sandbox server
https://sandbox.musement.com/api/v3
Production server
https://api.musement.com/api/v3
Headers
A partner's application value, used for analyzing API usage and to identify areas of improvement.
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
- Mock serverhttps://partner-api.musement.com/_mock/reference/openapi/carts/{cartUuid}
- Sandbox serverhttps://sandbox.musement.com/api/v3/carts/{cartUuid}
- Production serverhttps://api.musement.com/api/v3/carts/{cartUuid}
- curl
- C#
- Node.js
curl -i -X DELETE \
'https://partner-api.musement.com/_mock/reference/openapi/carts/{cartUuid}' \
-H 'X-Musement-Application: string' \
-H 'X-Musement-Version: 3.4.0'Request
Bundles are recommendations of other activities to purchase together with the activities in the current cart.
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 in cart.
Headers
The value of this parameter might affect the language of the content in the response, provided a translation in the requested language is available.
Default en-US
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.
Default USD
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.
Default us
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
- Mock serverhttps://partner-api.musement.com/_mock/reference/openapi/carts/{cartUuid}/bundles
- Sandbox serverhttps://sandbox.musement.com/api/v3/carts/{cartUuid}/bundles
- Production serverhttps://api.musement.com/api/v3/carts/{cartUuid}/bundles
- curl
- C#
- Node.js
curl -i -X GET \
'https://partner-api.musement.com/_mock/reference/openapi/carts/{cartUuid}/bundles' \
-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'Bundles for cart
Activities which can be bundled with the current activity.
Example: [{"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"}]
The type of bundle defines how its discount can affect prices:
from_second: the bundle discount only applies to the price of the activity in the bundle.no_discount: the bundle offers no discount.on_everything: the bundle discount applies to the combined price of both activities.
Enum"from_second""no_discount""on_everything"
Example: "no_discount"
A discount which can be applied based on the discount_type and bundle_type property values.
This property defines how to treat the discount property:
absolute: as a specific currency amount.percentage: as a percentage.
Enum"absolute""percentage"
Example: "percentage"
Response
application/json
[ { "discount": 0, "discount_type": "percentage", "bundle_type": "no_discount", "rule_id": "247", "activities": [ … ] } ]
Headers
A partner's application value, used for analyzing API usage and to identify areas of improvement.
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
- Mock serverhttps://partner-api.musement.com/_mock/reference/openapi/carts/{cartUuid}/items/{cartItemUuid}
- Sandbox serverhttps://sandbox.musement.com/api/v3/carts/{cartUuid}/items/{cartItemUuid}
- Production serverhttps://api.musement.com/api/v3/carts/{cartUuid}/items/{cartItemUuid}
- curl
- C#
- Node.js
curl -i -X DELETE \
'https://partner-api.musement.com/_mock/reference/openapi/carts/{cartUuid}/items/{cartItemUuid}' \
-H 'X-Musement-Application: string' \
-H 'X-Musement-Version: 3.4.0'