Musement API (3.4.0)

Download OpenAPI specification:Download

API distribution team: api-distribution@tui.com License: Apache 2.0 Terms of Service

For merchant or affiliate partners wishing to use the Musement API.

Authentication

Partner

The default security scheme for partners accessing the Musement API.

Security Scheme Type: OAuth2
Flow type: clientCredentials
Token URL: /login
Refresh URL: /refresh
Scopes:
  • comment -

    Partner is allowed to submit reviews for an activity.

  • no-payment -

    Partner is allowed to use the "no-payment flow" to pay for orders.

  • order-item-cancellation -

    Partner is allowed to cancel bookings.

Webhook

This security scheme is used by the Musement API when calling a partner's service.

Security Scheme Type: HTTP
HTTP Authorization Scheme basic

Release notes

2024-06-18

Endpoints

  • GET /activities/{activityUuid}/dates/{date}
    • Changed default min_buy value from -1 to 1

2024-02-21

Endpoints

  • Added GET /orders/{orderUuid}/refunds
    • Returns an array of paid refunds for an order

2024-02-20

Endpoints

  • GET /activities/{activityUuid}/dates/{date}
    • Added availability, max_buy and min_buy properties to timeslots. For more info, check out our guide

2023-02-13

Sandbox environment

2022-11-07

Endpoints

  • Added GET /activities/{activityUuid}/country
    • Returns the country associated with the activity's default city

2022-09-19

Endpoints

  • GET /activities/{activityUuid}/reviews
    • Added locale query parameter to filter reviews by their locale property
    • Raised maximum value for limit query parameter
    • Added the following headers to the response:
      • X-Number-Of-Elements
      • X-Total-Count
      • X-Total-Pages

2022-07-08

Activity model

  • Marked the following properties as deprecated:
    • when_text
    • reduced
    • verticals

2022-04-07

Headers

2022-02-10

Headers

  • 400 status code response for invalid X-Musement-Market header value

2022-01-21

Endpoints

  • Added GET /activities/{activityUuid}/reviews/statistics endpoint

2021-12-30

Endpoints

Added POST /activities/{activityUuid}/reviews endpoint

2019-05-30

Order model

  • Added CANCELLATION_ERROR order status