Carts

A collection of cart endpoints which are not strictly necessary for the booking flow.

Remove cart

Once a cart has been removed, it can no longer be accessed.

Returns an error if the cart cannot be removed due to a connected order.

Request
path Parameters
cartUuid
required
string <uuid>

The UUID of the cart.

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

Success

404

Resource not found

default

Error

delete/carts/{cartUuid}
Request samples
curl -i -X DELETE \
  'https://sandbox.musement.com/api/v3/carts/{cartUuid}' \
  -H 'X-Musement-Application: string' \
  -H 'X-Musement-Version: 3.4.0'
Response samples
application/json
true

Get bundles for cart

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.

Request
path Parameters
cartUuid
required
string <uuid>

The UUID of the cart.

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

Bundles for cart

404

Resource not found

default

Error

get/carts/{cartUuid}/bundles
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/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'
Response samples
application/json
[
  • {
    }
]

Remove item from cart

Use this endpoint to remove an item from cart.

This endpoint will return a 403 status code if the cart is part of a completed order.

Request
path Parameters
cartUuid
required
string <uuid>

The UUID of the cart.

cartItemUuid
required
string <uuid>

The UUID of the cart item.

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
204

Item removed successfully

403

Forbidden: unable to remove item due to cart's order status

404

Resource not found

default

Error

delete/carts/{cartUuid}/items/{cartItemUuid}
Request samples
curl -i -X DELETE \
  'https://sandbox.musement.com/api/v3/carts/{cartUuid}/items/{cartItemUuid}' \
  -H 'X-Musement-Application: string' \
  -H 'X-Musement-Version: 3.4.0'
Response samples
application/json
{
  • "code": "0",
  • "message": "You don't have permission to delete this resource."
}

Get product details for cart item

Request
path Parameters
cartUuid
required
string <uuid>

The UUID of the cart.

cartItemUuid
required
string <uuid>

The UUID of the cart item.

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

Product details

404

Resource not found

default

Error

get/carts/{cartUuid}/items/{cartItemUuid}/product-general-details
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/carts/{cartUuid}/items/{cartItemUuid}/product-general-details' \
  -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
{
  • "retail_price_with_custom_discount": {
    },
  • "retail_price_in_supplier_currency": {
    },
  • "seller_gateway": "Direct",
  • "ticket": false
}

Get order info for cart

This endpoint returns basic details about a cart's order (if it exists).

Request
path Parameters
cartUuid
required
string <uuid>

The UUID of the cart.

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

Order info

404

Not found: cart does not exist or is not connected to an order

default

Error

get/carts/{cartUuid}/order-info
Request samples
curl -i -X GET \
  'https://sandbox.musement.com/api/v3/carts/{cartUuid}/order-info' \
  -H 'X-Musement-Application: string' \
  -H 'X-Musement-Market: us' \
  -H 'X-Musement-Version: 3.4.0'
Response samples
application/json
{
  • "order_uuid": "e56795c7-0bc3-4742-a52f-988d2af8608f",
  • "payment": {
    }
}