Carts

A collection of deprecated endpoints for carts.

Update cartDeprecated

This endpoint has been replaced by multiple endpoints:

  • To add tickets to cart, use POST /carts/{cartUuid}/items.
  • To update customer info and extra customer data, use PUT /carts/{cartUuid}/customer.
  • To update participant info, use PUT /carts/{cartUuid}/items/{cartItemUuid}/participants.
Request
path Parameters
cartUuid
required
string <uuid>

The UUID of the cart.

query Parameters
affiliate
string

The name of the affiliate partner making the request.

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
Request Body schema: application/json

The request can be an empty object: {}

Tickets not already in the cart will be added. Existing tickets with a different quantity will be updated to match the submitted quantity.

object (Customer)
Array of objects
Responses
200

Cart

404

Resource not found

default

Error

patch/carts/{cartUuid}
Request samples
application/json
{
  • "customer": {
    },
  • "tickets": [
    ]
}
Response samples
application/json
{
  • "customer": {
    },
  • "discount": {
    },
  • "full_price": {
    },
  • "full_price_without_service_fee": {
    },
  • "items": [
    ],
  • "preferred_payment_gateway": "ADYEN",
  • "promo_code": {
    },
  • "retail_price": {
    },
  • "retail_price_without_service_fee": {
    },
  • "service_fee": {
    },
  • "total_discount": {
    },
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Replace cartDeprecated

Replace any existing customer info and/or tickets for the specified cart.

This endpoint has been replaced by multiple endpoints:

  • To add tickets to cart, use POST /carts/{cartUuid}/items.
  • To remove tickets from cart, use DELETE /carts/{cartUuid}/items/{cartItemUuid}.
  • To update customer info and extra customer data, use PUT /carts/{cartUuid}/customer.
  • To update participant info, use PUT /carts/{cartUuid}/items/{cartItemUuid}/participants.
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
Request Body schema: application/json

It is possible to remove items from cart by excluding the tickets property in the request.

However, customer info must always be part of the request.

required
object (Customer)
Array of objects
Responses
200

Cart

404

Resource not found

default

Error

put/carts/{cartUuid}
Request samples
application/json
{
  • "customer": {
    },
  • "tickets": [
    ]
}
Response samples
application/json
{
  • "customer": {
    },
  • "discount": {
    },
  • "full_price": {
    },
  • "full_price_without_service_fee": {
    },
  • "items": [
    ],
  • "preferred_payment_gateway": "ADYEN",
  • "promo_code": {
    },
  • "retail_price": {
    },
  • "retail_price_without_service_fee": {
    },
  • "service_fee": {
    },
  • "total_discount": {
    },
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Add tickets to cartDeprecated

Tickets are an older term for cart items.

This endpoint has been replaced by POST /carts/{cartUuid}/items.

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
Request Body schema: application/json
Array of objects

An array of products to add to cart.

Responses
200

Cart

404

Resource not found

423

Locked: cart is connected to a paid order and cannot be modified

default

Error

post/carts/{cartUuid}/tickets
Request samples
application/json
{
  • "tickets": [
    ]
}
Response samples
application/json
{
  • "customer": {
    },
  • "discount": {
    },
  • "full_price": {
    },
  • "full_price_without_service_fee": {
    },
  • "items": [
    ],
  • "preferred_payment_gateway": "ADYEN",
  • "promo_code": {
    },
  • "retail_price": {
    },
  • "retail_price_without_service_fee": {
    },
  • "service_fee": {
    },
  • "total_discount": {
    },
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Remove ticket from cartDeprecated

Tickets are an older term for cart items.

Returns the numeric ID of the cart.

This endpoint has been replaced by DELETE /carts/{cartUuid}/items/{cartItemUuid}.

Request
path Parameters
cartUuid
required
string <uuid>

The UUID of the cart.

ticketUuid
required
string <uuid> (Ticket UUID)

The UUID of the ticket.

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

Cart ID

403

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

404

Resource not found

default

Error

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