Activity Classification
We have two different ways to organize activities: by type or by geographical location.
Activities are organized by type using Categories, Verticals, Lists and by geographical location using Cities and Venues.
Below you can find a brief description of how to filter activity.


Geographical activity classification
City
The cities we cover with available inventory
Venue
The main POI we cover with activities available there, such as Vatican Museums, Eiffel Tower and more.
Type-related activities' classification
Categories
Regarding categories you can use two different endpoint:
- list categories
curl --location --request GET 'https://api.musement.com/api/v3/categories'
- tree level categories
curl --location --request GET 'https://api.musement.com/api/v3/categories-tree'
The difference between two endpoints is in the output format. /categories returns a list filterable for level (1,2,3,…) and for parent (father category in the tree). This help to create a tree but with some effort.
The /categories-tree endpoint will return the same data but already organized in tree format, in order to give the possibility to have a better overview of categories for all activities.
Time - related activity classification
Open date
Activities that do not have any schedule info. The customer buy the ticket and then can use whenever he want. There might be restriction for some particular day (Easter, Christmas etc). These restrictions are usually specified in the description.
For these activities the client application doesn't need to show the calendar during the purchase process because no date selection is required.
Open date activities have property open
set to true
in the activity model.
Daily
Tickets are valid for a specific day but there are no time restriction.
Daily activities have property daily
set to true
in the activity model.
Time based
Tickets are valid for a specific day and time.
Activity status
Status
You cannot filter by status
, since /activities
endpoint will return only ACTIVE
items. By accessing the specific activity details, instead, you can read different status
values.
Keep in mind that the complete order Workflow is intended to work only with ACTIVE
activities.
Updated 3 months ago