Musement API

The Musement API Developer Hub

Welcome to the Musement API developer hub. You'll find comprehensive guides and documentation to help you start working with Musement API as quickly as possible, as well as support if you get stuck. Let's jump right in!

Subscribe to the Musement API Docs Newsletter

API Reference

Swagger definition

Guides    API Reference

Make an Order

Now that the cart is created and all the information has been set, you now need to create the order

curl -X POST \
  https://api.musement.com/api/v3/orders \
  -H 'Authorization: Bearer validAccessToken' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json' \
  -H 'X-Musement-Version: 3.4.0' \
  -d '{
    "cart_uuid" : "[CART_UUID]"
}'

For the complete definition click here

Email notifications

If you want handle all communications with your customers you can send NONE as value for email_notification in the request above.

In this way no transactional email will be sent to the customer by Musement.
It's your duty to retrieve and send the valid voucher.

The response will be like

{
    "identifier": "MUS0738876",
    "uuid": "8bd6f4a4-ece7-4cf6-a1c4-2455b6f5f514",
    "date": "2018-08-17T15:59:43+0000",
    "status": "PENDING",
    "trustpilot_url": "https://us.trustpilot.com/evaluate/embed/www.musement.com?a=MUS0738876&b=Zm9vQHN0YXlvbG9neS5jb20=&c=Test+3.3.0+One+&e=bac16bfbee8271a62fa90988dd70065a0af93164&stars=5",
    "customer": {
        "email": "foo@musement.com",
        "firstname": "Mario",
        "lastname": "Rossi "
    },
    "items": [
        {
            "product": {
                "type": "musement",
                "max_confirmation_time": "P0D",
                "price_tag": {
                    "price_feature": "Tour",
                    "ticket_holder": "Adult",
                    "price_feature_code": "tour",
                    "ticket_holder_code": "adult"
                },
                "date": "2018-09-01 15:30",
                "id": "434696106",
                "title": "Exclusive skip-the-line guided visit of Leonardo da Vinci's vineyard",
                "api_url": "https://sandbox.musement.com/api/v3/activities/11eeb25c-2046-11e7-9cc9-06a7e332783f",
                "url": "https://sandbox.musement.com/us/milan/exclusive-skip-the-line-guided-visit-of-leonardo-da-vinci-s-vineyard-3936/",
                "cover_image_url": "https://images.musement.com/cover/0002/50/thumb_149030_cover_header.jpeg",
                "original_retail_price": {
                    "currency": "USD",
                    "value": 21,
                    "formatted_value": "$ 21.00"
                },
                "retail_price": {
                    "currency": "USD",
                    "value": 21,
                    "formatted_value": "$ 21.00"
                },
                "discount_amount": {
                    "currency": "USD",
                    "value": 0,
                    "formatted_value": "$ 0.00"
                },
                "service_fee": {
                    "currency": "USD",
                    "value": 0,
                    "formatted_value": "$ 0.00"
                }
            },
            "quantity": 2,
            "status": "PENDING",
            "vouchers": []
        }
    ],
    "total_price": {
        "currency": "USD",
        "value": 42,
        "formatted_value": "$ 42.00"
    },
    "affiliate": {
        "code": "affiliate_1"
    }
}

Make an Order


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.