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

{ 
	"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:

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:

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