# Categories

Categories give a general idea of an activity's main themes. Every activity belongs to at least one category. It is possible to group related activities by [filtering by category](/api/catalog/activities/searching#categories). Partners are encouraged to allow customers to navigate categories and sub-categories.

Categories are organized into a three-level tree structure. The main category at level one will always have one or more level-two categories. Each level-two category may have additional level-three categories, but this is not a requirement. A level-three category will always have level-two and level-one parent categories.

Here is an example of a level-one category with related level-two and level-three categories:


```json
{ 
	"id": 214, 
	"name": "Excursions & day trips", 
	"level": "1", 
	"code": "new-excursions-day-trips", 
	"children": [ 
		{ 
			"id": 215, 
			"name": "Boats", 
			"level": "2", 
			"code": "new-boats", 
			"children": [] 
		}, 
		{ 
			"id": 216, 
			"name": "Culture & history", 
			"level": "2", 
			"code": "new-cultural-historic", 
			"children": [ 
				{ 
					"id": 217, 
					"name": "Monument visits", 
					"level": "3", 
					"code": "new-monument-visits", 
					"children": [] 
				}, 
				{ 
					"id": 218, 
					"name": "Museums & art galleries", 
					"level": "3", 
					"code": "new-museums-art-galleries", 
					"children": [] 
				}, 
				{ 
					"id": 219, 
					"name": "Must-sees", 
					"level": "3", 
					"code": "new-must-sees", 
					"children": [] 
				}, 
				{ 
					"id": 220, 
					"name": "Seasonal events", 
					"level": "3", 
					"code": "new-seasonal-events", 
					"children": [] 
				} 
			] 
		}
	]
}
```

In the example above, the level-one *Excursions & day trips* category has a level-two *Boats* category (with no level-three categories) and a level-two *Culture & history* category with four level-three categories: *Monument visits*, *Museums & art galleries*, *Must-sees* and *Seasonal events*.

To get a tree-view list of categories, make the following request:


```bash
curl -X GET '{baseUrl}/categories-tree' \
-H 'X-Musement-Application: {applicationValue}' \
-H 'X-Musement-Version: 3.4.0' \
-H 'Authorization: Bearer {accessToken}'
```

To get a paginated list of categories, without the tree view, make the following request:


```bash
curl -X GET '{baseUrl}/categories' \
-H 'X-Musement-Application: {applicationValue}' \
-H 'X-Musement-Version: 3.4.0' \
-H 'Authorization: Bearer {accessToken}'
```

## All categories

Here is a complete list of all categories currently in use:

* Activities
  * Air activities
    * Cable cars
    * Helicopter rides
    * Hot-air balloon rides
  * City activities
    * Cruises
    * Hop-on hop-off
    * Shopping
  * Electric scooter tours
  * Golf
  * Great outdoors
    * Hiking & bike tours
    * Nature
    * Off-road
    * Other sports
    * Winter activities
  * Indoor activities
    * Classes & workshops
    * Cooking classes
    * Fun indoors
    * Wellness, fitness & spa
  * Night tours
  * Walking tours
  * Water activities
* Attractions & guided tours
  * Attraction passes
  * Exhibitions
  * Monuments
  * Museums
* Excursions & day trips
  * Boats
  * Culture & history
    * Monument visits
    * Museums & art galleries
    * Must-sees
    * Seasonal events
  * Food & drink
    * Drinks & tastings
    * Food & dining
  * Nightlife
  * Sightseeing & traditions
    * City
    * Countryside
    * Folklore
    * Markets & crafts
  * Travel for a cause
* Extras
  * Airport services
  * Childcare
  * Rental cars
* Tickets and events
  * Festival & concerts
  * Seasonal events
  * Sports
  * Theater & shows
  * Theme parks
  * Water parks
  * Zoos & aquariums
* Transfers
  * Bus transfers
  * Private transfers