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

Categories

\n

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.

\n

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.

\n

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

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

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.

\n

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

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

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

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

All categories

\n

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

\n","headings":[{"value":"Categories","depth":1},{"value":"All categories","depth":2}]},"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":"09c0dba5-7816-5772-ae80-803fa75b45d4__redocly content/api/catalog/categories/","seo":{"title":"Categories","description":"Categories give a general idea of an activity's main themes in the Musement API.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api/catalog/categories.md","pageBaseUrl":"/api/catalog/categories","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Categories","id":"categories"},{"depth":2,"value":"All categories","id":"all-categories"}]},"data":{"title":"","redirectFrom":["/guide/activity-categorization/categorization/","/api/partner/catalog/categories/"],"seo":{"description":"Categories give a general idea of an activity's main themes in the Musement API."}},"catalogInfo":null,"link":"/api/catalog/categories/","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"]}