Pickup points
Once a customer has found an activity, their next step in the booking flow depends on whether an activity has pickup points or not.
To check if an activity requires selecting a pickup point, make the following request:
curl -X GET '{baseUrl}/activities/{activityUuid}' \
-H 'X-Musement-Application: {applicationValue}' \
-H 'X-Musement-Version: 3.4.0' \
-H 'Authorization: Bearer {accessToken}'order_box_elements property in the response. Activities without pickup points will have the following value:{
[...]
"order_box_elements": [
"tours-and-activities"
],
[...]
}When an activity does not have pickup points, you can skip this step and move on to selecting a date.
Activities with pickup points will have the following value:
{
[...]
"order_box_elements": [
"tours-and-activities-with-pickup"
],
[...]
}When an activity has pickup points, customers must choose a pickup point before proceeding as available dates and options may vary for each point.
Getting pickup points
To get a list of pickup points, make the following request:
curl -X GET '{baseUrl}/activities/{activityUuid}/pickups' \
-H 'X-Musement-Application: {applicationValue}' \
-H 'X-Musement-Version: 3.4.0' \
-H 'Authorization: Bearer {accessToken}'The response will contain pickup points for the activity:
[
[...]
{
"uuid": "4fd4f187-cecc-4fb1-b619-9f41bfb05c5a",
"type": "HOTEL",
"name": "Aguait resort & spa tui sensimar",
"latitude": 39.695,
"longitude": 3.45416,
"tags": [
{
"id": "6648"
}
]
},
{
"uuid": "f49bd49a-d56b-4cff-a918-3d775c0838c9",
"type": "PICKUP",
"name": "Taxi stop hotel melbeach",
"latitude": 39.65577,
"longitude": 3.43884,
"tags": []
},
[...]
]uuid property for subsequent calls in the booking flow.On musement.com
You can see pickup points in action on musement.com.
Activities with pickup points require selecting a pickup from a dropdown menu before allowing customers to select a date:
