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

Taxonomies

\n

Taxonomy provides information about the activity’s highlights, inclusions and exclusions. Highlights contain the main selling points for an activity. Inclusions contain benefits that customers will receive for the activity while exclusions indicate benefits that are not part of the activity. This information is not required when providers create an activity, but it is highly encouraged in order to keep customers informed.

\n

To get the taxonomy for a specific activity, make the following request:

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

The response contains all highlights, inclusions and exclusions for the activity:

\n
\n
\n
Copy
\n
Copied
\n
\n 
[\n\t[...]\n\t{\n\t\t\"uuid\":\"acadd4d5e4e8f4e24bb89d9e76a56888\",\n\t\t\"name\":\"Skip-the-line tickets to the Vatican Museums and the Sistine Chapel (entrance at the selected times...\",\n\t\t\"type\":\"INCLUSION\",\n\t\t\"category\":\"NO-STANDARD\"\n\t},\n\t{\n\t\t\"uuid\":\"c326e4c6bf15190d2901976de2e26049\",\n\t\t\"name\":\"Entrance to St. Peter's Basilica\",\n\t\t\"type\":\"EXCLUSION\",\n\t\t\"category\":\"NO-STANDARD\"\n\t},\n\t{\n\t\t\"uuid\":\"144e1ec182d26d189271c4872e932fc0\",\n\t\t\"name\":\"VIP entrance option: access the Vatican Museums in the quickest possible way thanks to your accompan...\",\n\t\t\"type\":\"HIGHLIGHT\",\n\t\t\"category\":\"NO-STANDARD\"\n\t},\n\t[...]\n]
\n
\n

To get a list of all available taxonomies for a specific taxonomy type, make the following request:

\n
\n
\n
Copy
\n
Copied
\n
\n 
curl -X GET '{baseUrl}/activity-taxonomies/{activityTaxonomyType}' \\\n-H 'X-Musement-Application: {applicationValue}' \\\n-H 'X-Musement-Version: 3.4.0' \\\n-H 'Authorization: Bearer {accessToken}'
\n
\n

The response provides all the taxonomies for the specified taxonomy type. There are three taxonomy types in total:

\n\n

Here is an example response for highlights:

\n
\n
\n
Copy
\n
Copied
\n
\n 
[\n\t[...]\n\t{\n\t\t\"uuid\":\"7a1db21d-51e1-11e7-96a2-06d26c7657b2\",\n\t\t\"name\":\"Lunch menu to keep you going all day\",\n\t\t\"category\":\"MEALS\"\n\t},\n\t{\n\t\t\"uuid\":\"7a1db53d-51e1-11e7-96a2-06d26c7657b2\",\n\t\t\"name\":\"Avoid the traffic of the city with an airport transfer\",\n\t\t\"category\":\"TRANSPORTATION\"\n\t}\n\t[...]\n]
\n
\n

You can see taxonomies in action on musement.com. Highlights are displayed near the top of the page in the section Do this because:

\n

\n and What's not included:

\n

\n \n \n

\n

If an activity does not have highlights, inclusions or exclusions, these sections are not displayed on the page.

","headings":[{"value":"Taxonomies","depth":1}]},"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":"96740abb-f801-5c28-987d-de9896f38a2b__redocly content/api/catalog/activities/taxonomies/","seo":{"title":"Taxonomies","description":"Taxonomy provides information about the activity’s highlights, inclusions and exclusions via the Musement API.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api/catalog/activities/taxonomies.md","pageBaseUrl":"/api/catalog/activities/taxonomies","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Taxonomies","id":"taxonomies"}]},"data":{"title":"","redirectFrom":["/guide/activities/taxonomy/","/api/partner/catalog/activities/taxonomies/"],"seo":{"description":"Taxonomy provides information about the activity’s highlights, inclusions and exclusions via the Musement API."}},"catalogInfo":null,"link":"/api/catalog/activities/taxonomies/","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"]}