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

Pickup points

\n

The Musement catalog contains activities which may offer customers pickup from their hotel or designated locations. In some cases, this option is presented as extra customer data which can be displayed at checkout.

\n

However, pickup points can also to a type of pickup which must be selected at the beginning of the booking flow since available dates, options and prices can change based on the selected pickup.

\n

Differentiating between the two pickup cases can be confusing, as both may use the same value in an activity's services property:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n\t[...]\n\t\"services\": [\n\t\t{\n\t\t\t\"code\": \"pick-up\",\n\t\t\t\"name\": \"Hotel pick up\"\n\t\t}\n\t],\n\t[...]\n}
\n
\n

Partners are expected to use an activity's order_box_elements property to correctly identify the booking flow for an activity.

\n

Activities without pickup points will have the following value:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n\t[...]\n\t\"order_box_elements\": [\n\t\t\"tours-and-activities\"\n\t],\n\t[...]\n}
\n
\n

When an activity does not have pickup points, customers do not select pickup at the beginning of the booking flow.

\n

Activities with pickup points will have the following value:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n\t[...]\n\t\"order_box_elements\": [\n\t\t\"tours-and-activities-with-pickup\"\n\t],\n\t[...]\n}
\n
\n

When an activity has this kind of pickup points, customers must choose a pickup point at the beginning of the booking flow.

\n

To get a list of pickup points for an activity, make the following request:

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

The response contains a list of all the available pickup points:

\n
\n
\n
Copy
\n
Copied
\n
\n 
[\n\t[...]\n\t{\n\t\t\"uuid\": \"4fd4f187-cecc-4fb1-b619-9f41bfb05c5a\",\n\t\t\"type\": \"HOTEL\",\n\t\t\"name\": \"Aguait resort & spa tui sensimar\",\n\t\t\"latitude\": 39.695,\n\t\t\"longitude\": 3.45416,\n\t\t\"tags\": [\n\t\t\t{\n\t\t\t\t\"id\": \"6648\"\n\t\t\t}\n\t\t]\n\t},\n\t{\n\t\t\"uuid\": \"f49bd49a-d56b-4cff-a918-3d775c0838c9\",\n\t\t\"type\": \"PICKUP\",\n\t\t\"name\": \"Taxi stop hotel melbeach\",\n\t\t\"latitude\": 39.65577,\n\t\t\"longitude\": 3.43884,\n\t\t\"tags\": []\n\t},\n\t[...]\n]
\n
\n

Once a pickup point has been selected, its uuid must be provided for most steps in the booking flow. In the example below, we are requesting available dates for a specific pickup in an activity:

\n
\n
\n
Copy
\n
Copied
\n
\n 
curl -X GET '{baseUrl}/activities/{activityUuid}/dates?pickup={pickupUuid}' \\\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 the booking flow for activities with pickup points, refer to the dedicated page.

","headings":[{"value":"Pickup points","depth":1}]},"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":"549f65bc-c75f-549a-87a9-bb5e749a4cc7__redocly content/api/catalog/activities/pickup-points/","seo":{"title":"Pickup points","description":"Some activities allow customers to select pickup locations for their booked activity.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api/catalog/activities/pickup-points.md","pageBaseUrl":"/api/catalog/activities/pickup-points","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Pickup points","id":"pickup-points"}]},"data":{"title":"","redirectFrom":["/guide/activities/pickup-points/","/api/partner/catalog/activities/pickup-points/"],"seo":{"description":"Some activities allow customers to select pickup locations for their booked activity."}},"catalogInfo":null,"link":"/api/catalog/activities/pickup-points/","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"]}