{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/api/catalog/activities/prices/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Prices

\n

Prices for activities appear in the responses for the following endpoints:

\n
    \n
  1. \n/activities/{activityUuid}\n
    2. \n
  2. \n/activities/{activityUuid}/dates\n
    3. \n
  3. \n/activities/{activityUuid}/dates/{date}\n
    4. \n
\n

Currency

\n

The currency for prices is based on the value of the X-Musement-Currency header. If the header is missing, USD will be used by default.

\n

To learn more about currencies in responses, check out the currency guide.

\n

Price properties

\n

Multiple properties describe prices and their characteristics:

\n\n

In the example response below, the activity has a discount, service fee and a merchant_price:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n\t[...]\n\t\"service_fee\": {\n\t\t\"currency\": \"USD\",\n\t\t\"value\": 1.0,\n\t\t\"formatted_value\": \"$ 1.00\",\n\t\t\"formatted_iso_value\": \"$1.00\"\n\t},\n\t[...]\n\t\"original_retail_price\": {\n\t\t\"currency\": \"USD\",\n\t\t\"value\": 49.0,\n\t\t\"formatted_value\": \"$ 49.00\",\n\t\t\"formatted_iso_value\": \"$49.00\"\n\t},\n\t\"original_retail_price_without_service_fee\": {\n\t\t\"currency\": \"USD\",\n\t\t\"value\": 48.0,\n\t\t\"formatted_value\": \"$ 48.00\",\n\t\t\"formatted_iso_value\": \"$48.00\"\n\t},\n\t\"discount_amount\": {\n\t\t\"currency\": \"USD\",\n\t\t\"value\": 4.9,\n\t\t\"formatted_value\": \"$ 4.90\",\n\t\t\"formatted_iso_value\": \"$4.90\"\n\t},\n\t\"retail_price\": {\n\t\t\"currency\": \"USD\",\n\t\t\"value\": 44.1,\n\t\t\"formatted_value\": \"$ 44.10\",\n\t\t\"formatted_iso_value\": \"$44.10\"\n\t},\n\t\"retail_price_without_service_fee\": {\n\t\t\"currency\": \"USD\",\n\t\t\"value\": 43.1,\n\t\t\"formatted_value\": \"$ 43.10\",\n\t\t\"formatted_iso_value\": \"$43.10\"\n\t},\n\t\"merchant_price\": {\n\t\t\"currency\": \"USD\",\n\t\t\"value\": 40.18,\n\t\t\"formatted_value\": \"$ 40.18\",\n\t\t\"formatted_iso_value\": \"$40.18\"\n\t},\n\t[...]\n}
\n
\n

In the above example, customers are expected to pay the retail_price of $44.10. Partners are expected to pay Musement the merchant_price of $40.18.

\n

Sorting

\n

You can sort results in the /activities endpoint by price, using the sort_by query parameter.

\n

A sort_by value of price will sort results from the lowest to the highest prices:

\n
\n
\n
Copy
\n
Copied
\n
\n 
curl -X GET '{baseUrl}/activities?sort_by=price' \\\n-H 'X-Musement-Application: {applicationValue}' \\\n-H 'X-Musement-Version: 3.4.0' \\\n-H 'Authorization: Bearer {accessToken}'
\n
\n

To sort results from highest to lowest prices, use a sort_by value of -price:

\n
\n
\n
Copy
\n
Copied
\n
\n 
curl -X GET '{baseUrl}/activities?sort_by=-price' \\\n-H 'X-Musement-Application: {applicationValue}' \\\n-H 'X-Musement-Version: 3.4.0' \\\n-H 'Authorization: Bearer {accessToken}'
\n
\n

A note on sandbox prices

\n

Be aware that prices in the sandbox environment may be fake prices set for testing purposes and do not necessarily represent the prices shown in the production environment.

","headings":[{"value":"Prices","depth":1},{"value":"Currency","depth":2},{"value":"Price properties","depth":2},{"value":"Sorting","depth":2},{"value":"A note on sandbox prices","depth":2}]},"contentItem":{"data":{"lastModified":"2025-12-18T16:31:42.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"5fcc21cc-652e-530f-a089-0a55b572c17f__redocly content/api/catalog/activities/prices/","seo":{"title":"Prices","description":"Understand activity price details in the Musement API so that customers can see how much an experience will cost.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api/catalog/activities/prices.md","pageBaseUrl":"/api/catalog/activities/prices","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Prices","id":"prices"},{"depth":2,"value":"Currency","id":"currency"},{"depth":2,"value":"Price properties","id":"price-properties"},{"depth":2,"value":"Sorting","id":"sorting"},{"depth":2,"value":"A note on sandbox prices","id":"a-note-on-sandbox-prices"}]},"data":{"title":"","redirectFrom":["/guide/pricing/activity-prices/","/api/partner/catalog/activities/activity-prices/","/api/partner/catalog/activities/prices/"],"seo":{"description":"Understand activity price details in the Musement API so that customers can see how much an experience will cost."}},"catalogInfo":null,"link":"/api/catalog/activities/prices/","sidebarName":"__alternative-sidebar__-data-24763-api-sidebars.yaml","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}