Searching activities

The first step to finding a product is searching through the activities in our catalog.

You can get activities by using the following request:

Copy

Copied

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

The paginated response contains a list of activities, specifically those which are available for bookings:

Copy

Copied

{
	"meta": {
		"count": 7442
	},
	"data": [
		[...]
		{
			[...]
			"uuid": "5a002d99-781b-479b-9a9d-9efadfd34ec2",
			"title": "Caccia al tesoro a Milano per bambini",
			[...]
		}
		[...]
	]
}

Filters

The endpoint accepts multiple query parameter filters, such as cities and available dates. For more information about filters, check out the dedicated section in the guide as well as the API reference.

Sorting

By default, activities in the response are sorted by relevance, our default sorting property. You can sort results by distance from a set of coordinates, pricing, ratings and other types of relevance.

Activity info

While the /activities endpoint response contains some details about each activity, it does not contain everything that customers might find useful. Partners should be prepared to call multiple endpoints for a single activity to give customers greater visibility to refund policies, images, available languages, pricing, meeting points and more.

When calling other endpoints, use an activity's uuid property as part of the path:

Copy

Copied

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

For more information about fantastic activity characteristics (and where to find them), check out our dedicated section.