{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/api/booking-flow/product/searching/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Searching activities

\n

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

\n

You can get activities by using the following request:

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

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

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

Filters

\n

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.

\n

Sorting

\n

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.

\n

Activity info

\n

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.

\n

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

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

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

","headings":[{"value":"Searching activities","depth":1},{"value":"Filters","depth":2},{"value":"Sorting","depth":2},{"value":"Activity info","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":"9dfd300b-5d4f-57f4-ad60-2d21d324d8bd__redocly content/api/booking-flow/product/searching/","seo":{"title":"Searching activities","description":"Searching through activities in the Musement API is the first key step to the booking flow.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api/booking-flow/product/searching.md","pageBaseUrl":"/api/booking-flow/product/searching","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Searching activities","id":"searching-activities"},{"depth":2,"value":"Filters","id":"filters"},{"depth":2,"value":"Sorting","id":"sorting"},{"depth":2,"value":"Activity info","id":"activity-info"}]},"data":{"title":"","redirectFrom":["/guide/activities/general-overview/","/api/partner/booking-flow/product/general-overview/","/api/partner/booking-flow/product/searching/"],"seo":{"description":"Searching through activities in the Musement API is the first key step to the booking flow."}},"catalogInfo":null,"link":"/api/booking-flow/product/searching/","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"]}