# Add tickets to cart (deprecated)

Tickets are an older term for cart items.

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

Endpoint: POST /carts/{cartUuid}/tickets
Version: 3.5.0

## Path parameters:

  - `cartUuid` (string, required)
    The UUID of the cart.

## Header parameters:

  - `Accept-Language` (string)
    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)
    A partner's application value, used for analyzing API usage and to identify areas of improvement.

  - `X-Musement-Currency` (string)
    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 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)
    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 fields (application/json):

  - `tickets` (array)
    An array of products to add to cart.
    Example: [{"product":{"type":"musement","id":"4445092627"},"quantity":2}]

  - `tickets.product` (object)
    The product to add to cart.
    Example: {"type":"musement","id":"4445092627"}

  - `tickets.product.id` (string)
    The product identifier.
    Example: "4445092627"

  - `tickets.product.type` (string)
    The type of product.
    Enum: "musement", "musement-realtime"

  - `tickets.quantity` (integer)
    The number of products to add to cart.
    Example: 2

## Response 200 fields (application/json):

  - `customer` (object)
    The cart's customer info.
    Example: {"email":"api-distribution@tui.com","events_related_newsletter":"NO","extra_customer_data":{"1223356a-69a0-4c45-bf51-bd903820d210":{"phone_number":1234567890}},"firstname":"John","lastname":"Smith","musement_newsletter":"NO","thirdparty_newsletter":"NO"}

  - `customer.country` (object)
    The customer's country.

  - `customer.country.country_prefix` (string)
    The country's main telephone country code.
    Example: "+39"

  - `customer.country.currency_code` (string)
    The main currency for the country as a Musement currency code. For a complete list of currencies, refer to the /currencies endpoint.
    Example: "EUR"

  - `customer.country.iso_code` (string, required)
    The two-character ISO code for the country.
    Example: "IT"

  - `customer.country.iso3char` (string, required)
    The three-character ISO code for the country.
    Example: "ITA"

  - `customer.country.name` (string, required)
    The country's name, translated based on the Accept-Language header value.
    Example: "Italy"

  - `customer.country.id` (integer, required)
    The country's numeric ID. This property will be removed in the future.
    Example: 82

  - `customer.email` (string)
    The customer's email address.
    Example: "api-distribution@tui.com"

  - `customer.extra_customer_data` (object)
    Extra customer data, based on the customer's cart items.
    Example: {"1223356a-69a0-4c45-bf51-bd903820d210":{"phone_number":1234567890}}

  - `customer.firstname` (string)
    The customer's first name.
    Example: "John"

  - `customer.lastname` (string)
    The customer's last name.
    Example: "Smith"

  - `customer.thirdparty_newsletter` (string)
    Whether the customer wants to receive newsletters from third parties or not.
    Enum: "NO", "YES"

  - `customer.musement_newsletter` (string)
    Whether the customer wants to receive newsletters from Musement or not.
    Enum: "NO", "YES"

  - `customer.events_related_newsletter` (string)
    Whether the customer wants to receive newsletters for related activities or not.
    Enum: "NO", "YES"

  - `customer.id` (integer)

  - `customer.avatar` (string)

  - `customer.currency` (object)

  - `customer.currency.code` (string)
    The currency's unique identifying code.
    Example: "USD"

  - `customer.currency.name` (string)
    The currency's name, translated based on the Accept-Language header value.
    Example: "US Dollar"

  - `customer.currency.symbol` (string)
    The currency's symbol.
    Example: "$"

  - `customer.birthdate` (string)
    Example: "1970-04-13"

  - `customer.gender` (object)

  - `customer.gender.code` (string)
    Customer's gender code. Possible values are:
 * MALE: Male
 * FEMALE: Female
 * OTHER: Other
    Enum: "MALE", "FEMALE", "OTHER"

  - `customer.gender.name` (string)
    Customer's gender label. | This value depends on the value of the header Accept-Language

  - `customer.id_number` (string)

  - `customer.mobile` (string)

  - `customer.address` (string)

  - `customer.favourite_city` (object)

  - `customer.favourite_city.activities_count` (integer)
    The number of available activities for the city.

  - `customer.favourite_city.id` (integer)
    The city's numeric ID.

  - `customer.favourite_city.code` (string)
    A string identifier for the city, based on the English version of the city name. This property is not affected by the Accept-Language header.

  - `customer.favourite_city.content` (string)
    A plain text description of the city, translated according to the Accept-Language header value.

  - `customer.favourite_city.content_html` (string)
    A description of the city with HTML tags, translated according to the Accept-Language header value.

  - `customer.favourite_city.country` (object)

  - `customer.favourite_city.cover_image_url` (string)
    A URL for the city's cover image.

  - `customer.favourite_city.event_count` (integer)
    The number of available activities for the city.

  - `customer.favourite_city.headline` (string)
    An SEO-friendly version of the city name for a page headline, translated based on the Accept-Language header value.

  - `customer.favourite_city.latitude` (number)

  - `customer.favourite_city.longitude` (number)

  - `customer.favourite_city.list_count` (integer)
    The number of available Musement list pages for the city.

  - `customer.favourite_city.meta_description` (string)
    An SEO-friendly description of the city, translated based on the Accept-Language header value.

  - `customer.favourite_city.meta_title` (string)
    An SEO-friendly version of the city name, translated based on the Accept-Language header value.

  - `customer.favourite_city.name` (string)
    The name of city, translated according to the Accept-Language header value.

  - `customer.favourite_city.slug` (string)
    The city slug, used for creating the city URL. Changes based on the value of the Accept-Language value.

  - `customer.favourite_city.time_zone` (string)
    The city's time zone.

  - `customer.favourite_city.top` (boolean)
    When true, the city is considered one of Musement's most popular cities.

  - `customer.favourite_city.url` (string)
    An automatically generated Musement URL for the city based on the X-Musement-Market header and slug property. The URL is only valid for select X-Musement-Market values and cities.

  - `customer.favourite_city.uuid` (string)
    The city's UUID.

  - `customer.favourite_city.venue_count` (integer)
    The number of available venues in the city.

  - `customer.favourite_city.weight` (integer)
    A property used for ranking multiple cities by popularity. Top selling cities will have a higher value.

  - `customer.favourite_city.more` (string)
    Additional information about the city in plain text, ideal for a "Read more" section, translated based on the Accept-Language header value.

  - `customer.favourite_city.more_html` (string)
    Additional information about the city with HTML tags, ideal for a "Read more" section, translated based on the Accept-Language header value.

  - `customer.locale` (string)

  - `discount` (object)
    Discount info for the cart if a promo code has been applied.
    Example: {"currency":"USD","formatted_value":"$ 10.00","formatted_iso_value":"$10.00","value":10}

  - `discount.currency` (string, required)
    The currency of the price, using a currency code from the /currencies endpoint.
    Example: "USD"

  - `discount.formatted_iso_value` (string, required)
    The price and currency, formatted based on the value of the Accept-Language header value.
    Example: "$10.00"

  - `discount.formatted_value` (string, required)
    The currency symbol and price, separated by a space.
    Example: "$ 10.00"

  - `discount.value` (number, required)
    The numeric value of the price.
    Example: 10

  - `full_price` (object)
    The sum of every product's original_retail_price property value multiplied by the corresponding cart item's quantity.
    Example: {"currency":"USD","formatted_value":"$ 10.00","formatted_iso_value":"$10.00","value":10}

  - `full_price_without_service_fee` (object)
    The sum of every product's original_retail_price_without_service_fee property value multiplied by the corresponding cart item's quantity.
    Example: {"currency":"USD","formatted_value":"$ 10.00","formatted_iso_value":"$10.00","value":10}

  - `items` (array)
    The cart items.

  - `items.product` (object)
    The selected product.
    Example: {"activity_uuid":"df542cb8-8fca-44d0-94e6-715399c783f0","api_url":"https://sandbox.musement.com/api/v3/activities/df542cb8-8fca-44d0-94e6-715399c783f0","cover_image_url":"https://images-sandbox.musement.com/cover/0001/93/washington-d-c-day-tour-from-new-york-city-1_header-92769.jpeg","date":"2022-05-01 10:15","discount_amount":{"currency":"EUR","formatted_value":"€ 0.00","formatted_iso_value":"€0.00","value":0},"id":"4445102588","language":{"code":"en","name":"English"},"max_confirmation_time":"P0D","original_retail_price":{"currency":"EUR","formatted_value":"€ 9.00","formatted_iso_value":"€9.00","value":9},"original_retail_price_without_service_fee":{"currency":"EUR","formatted_value":"€ 9.00","formatted_iso_value":"€9.00","value":9},"retail_price":{"currency":"EUR","formatted_value":"€ 9.00","formatted_iso_value":"€9.00","value":9},"retail_price_without_service_fee":{"currency":"EUR","formatted_value":"€ 9.00","formatted_iso_value":"€9.00","value":9},"service_fee":{"currency":"EUR","formatted_value":"€ 0.00","formatted_iso_value":"€0.00","value":0},"title":"Calendar activity with pickups and multiple price tag features","type":"musement","url":"https://.sbox.musement.com/bo-2b/washington-dc/calendar-activity-with-pickups-and-multiple-price-tag-features-175737/"}

  - `items.product.activity_uuid` (string)
    The UUID of the selected activity.
    Example: "df542cb8-8fca-44d0-94e6-715399c783f0"

  - `items.product.api_url` (string)
    The API endpoint to use for more information about the selected activity.
    Example: "https://sandbox.musement.com/api/v3/activities/df542cb8-8fca-44d0-94e6-715399c783f0"

  - `items.product.cover_image_url` (string)
    A URL for the activity's cover image.
    Example: "https://images-sandbox.musement.com/cover/0001/93/washington-d-c-day-tour-from-new-york-city-1_header-92769.jpeg"

  - `items.product.date` (string)
    The selected date and time in the following format: Y-m-d H:i.
    Example: "2022-05-01 10:15"

  - `items.product.discount_amount` (object)
    A discount to subtract from the the "base price", for a quantity of 1, due to promotions or special events.
    Example: {"currency":"USD","formatted_value":"$ 10.00","formatted_iso_value":"$10.00","value":10}

  - `items.product.id` (string)
    The ID of the selected product.
    Example: "4445102588"

  - `items.product.language` (object)
    The selected language for the product.
    Example: {"code":"en","name":"English"}

  - `items.product.language.code` (string, required)
    The language code, following RFC 3066.
    Example: "en"

  - `items.product.language.name` (string, required)
    The name of the language, translated based on the Accept-Language header value.
    Example: "English"

  - `items.product.max_confirmation_time` (string)
    The maximum amount of time an activity provider needs to process a reservation request. Values follow the ISO 8601 standard.

This property is not used for instant confirmation activities.
    Example: "P0D"

  - `items.product.original_retail_price` (object)
    The base price for a quantity of 1 with a service fee, but no discount.
    Example: {"currency":"USD","formatted_value":"$ 10.00","formatted_iso_value":"$10.00","value":10}

  - `items.product.original_retail_price_without_service_fee` (object)
    The base price for a quantity of 1 with a discount, but no service fee.
    Example: {"currency":"USD","formatted_value":"$ 10.00","formatted_iso_value":"$10.00","value":10}

  - `items.product.pickup` (object)
    The selected pickup.
    Example: {"latitude":39.7191046,"longitude":3.4578191,"name":"Allsun Hotel Lux de Mar","tags":[{"id":"AC5257025","type":"CONTENT-MANAGER-DATA"},{"id":"472","type":"HOTEL-CODE"}],"type":"HOTEL","uuid":"c2326f61-c0d7-4353-8a1f-c1f12c4249f3"}

  - `items.product.pickup.name` (string)
    The name of the pickup location.
    Example: "Allsun Hotel Lux de Mar"

  - `items.product.pickup.place` (string)

  - `items.product.pickup.tags` (array)
    Example: [{"id":"AC5257025","type":"CONTENT-MANAGER-DATA"},{"id":"472","type":"HOTEL-CODE"}]

  - `items.product.pickup.tags.id` (string, required)
    The pickup tag's alphanumeric ID.

  - `items.product.pickup.tags.type` (string, required)
    The type of tag.
    Enum: "CONTENT-MANAGER-DATA", "HOTEL-CODE", "SUPPLIER"

  - `items.product.pickup.type` (string)
    The type of pickup:

* HOTEL: A hotel where customers can wait in the lobby.
* PICKUP: A general location. Customers may need to wait outside.
    Enum: "HOTEL", "PICKUP"

  - `items.product.pickup.uuid` (string)
    The pickup's UUID.
    Example: "c2326f61-c0d7-4353-8a1f-c1f12c4249f3"

  - `items.product.price_tag` (object)
    The selected option.
    Example: {"age_info":"18+","price_feature":"Tour","price_feature_code":"tour","ticket_holder":"Adult","ticket_holder_code":"adult"}

  - `items.product.price_tag.age_info` (string)
    The age range for the product. This could be depicted as a range with both a lower and a higher bound (such as 3-17) or as a single lower bound (such as 18+).
    Example: "18+"

  - `items.product.price_tag.price_feature` (string)
    The price tag feature, aka ticket option, translated based on the Accept-Language header value.
    Example: "Tour"

  - `items.product.price_tag.price_feature_code` (string)
    The unique alphanumeric identifier for the feature, aka ticket option.
    Example: "tour"

  - `items.product.price_tag.ticket_holder` (string)
    The price tag holder, translated based on the Accept-Language header value.
    Example: "Adult"

  - `items.product.price_tag.ticket_holder_code` (string)
    The unique alphanumerical identifier for the product's ticket holder.
    Example: "adult"

  - `items.product.retail_price` (object)
    The final price for customers for a quantity of 1.
    Example: {"currency":"USD","formatted_value":"$ 10.00","formatted_iso_value":"$10.00","value":10}

  - `items.product.retail_price_without_service_fee` (object)
    The base price for a quantity of 1 with a discount, but no service fee.
    Example: {"currency":"USD","formatted_value":"$ 10.00","formatted_iso_value":"$10.00","value":10}

  - `items.product.service_fee` (object)
    An extra fee to add to the base price, for a quantity of 1, to cover additional costs for creating a reservation.
    Example: {"currency":"USD","formatted_value":"$ 10.00","formatted_iso_value":"$10.00","value":10}

  - `items.product.title` (string)
    The title of the selected activity, translated based on the Accept-Language header value.
    Example: "Calendar activity with pickups and multiple price tag features"

  - `items.product.type` (string)
    The type of product.
    Enum: "musement", "musement-realtime"

  - `items.product.url` (string)
    An automatically generated Musement URL for the selected activity based on the X-Musement-Market header and item properties. The URL is only valid for select X-Musement-Market values and activities.
    Example: "https://.sbox.musement.com/bo-2b/washington-dc/calendar-activity-with-pickups-and-multiple-price-tag-features-175737/"

  - `items.quantity` (integer)
    The quantity of requested product.

  - `items.status` (string)
    The status of the cart item:

  * PREBOOK_KO: the cart item is no longer available.
  * PREBOOK_OK: the cart item is still available for purchase.
    Enum: "PREBOOK_OK", "PREBOOK_KO"

  - `items.total_price` (object)
    The product's retail_price multiplied by the cart's quantity property.
    Example: {"currency":"USD","formatted_value":"$ 10.00","formatted_iso_value":"$10.00","value":10}

  - `items.total_price_without_service_fee` (object)
    The product's retail_price_without_service_fee multiplied by the cart's quantity property.
    Example: {"currency":"USD","formatted_value":"$ 10.00","formatted_iso_value":"$10.00","value":10}

  - `items.uuid` (string)
    The cart item's UUID.

  - `preferred_payment_gateway` (string)
    This property defines which payment gateway should be used for partners following the split payment flow.
    Enum: "ADYEN", "STRIPE"

  - `promo_code` (object)
    The promo code (if any) applied to cart for a discount.

  - `promo_code.code` (string)

  - `retail_price` (object)
    This property is the final price for customers. It is the sum of every cart item's total_price property value minus the cart's discount value.
    Example: {"currency":"USD","formatted_value":"$ 10.00","formatted_iso_value":"$10.00","value":10}

  - `retail_price_without_service_fee` (object)
    The sum of every cart item's total_price_without_service_fee property value minus the cart's discount value.
    Example: {"currency":"USD","formatted_value":"$ 10.00","formatted_iso_value":"$10.00","value":10}

  - `service_fee` (object)
    The sum of every product's service_fee property value.
    Example: {"currency":"USD","formatted_value":"$ 10.00","formatted_iso_value":"$10.00","value":10}

  - `total_discount` (object)
    The sum of:

  * The cart's discount property
  * Every product's discount_amount property value multiplied by the corresponding cart item's quantity.
    Example: {"currency":"USD","formatted_value":"$ 10.00","formatted_iso_value":"$10.00","value":10}

  - `uuid` (string)
    The UUID of the cart.

## Response 404 fields (application/json):

  - `code` (string, required)
    The internal Musement code for the error.
    Example: "1400"

  - `message` (string, required)
    A message with a brief explanation of the error.
    Example: "Resource does not exist"

## Response 423 fields (application/json):

  - `code` (string, required)
    The internal Musement code for the error.
    Example: "-1"

  - `message` (string, required)
    A message with a brief explanation of the error.
    Example: "Cart is already connected to order with state 'closed'"

## Response default fields (application/json):

  - `code` (string, required)
    The internal Musement code for the error.
    Example: "0"

  - `message` (string, required)
    A message with a brief explanation of the error.
    Example: "There was an error"