# 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:


```bash
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:


```json
[
	[...]
	{
		"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:


```bash
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`:


```json
[
	[...]
	{
		"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](https://www.musement.com). Highlights are displayed near the top of the page in the section *Do this because*:

![Highlights on musement.com](/assets/do-this-because.9c5ca9998b3554142234ecb9b452d934f09686a1a8dd42e32b02398c395686bd.ae54516e.png)

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](/assets/inclusions-exclusions.af6f7797eab29035ead5795e605bf4b0bfcc753f3499524141677795eced6ede.ae54516e.png)

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