Taxonomies

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.

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

Copy

Copied

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

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

Copy

Copied

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

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

Copy

Copied

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

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

highlights
inclusions
exclusions

Here is an example response for highlights:

Copy

Copied

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

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

Highlights on musement.com

Inclusions and exclusions are displayed together farther down the page after the description, in the sections What's included and What's not included:

Inclusions and exclusions on musement.com

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