Participant info

Some activities in the Musement catalog require participant info: mandatory information about each person in the booking.

While each activity provides a preview of participant info at /activities/{activityUuid}/participants-info/schema, the requested info may change for a cart item. The definitive participant info for a cart item is available by making the following request:

Copy

Copied

curl -X GET '{baseUrl}/carts/{cartUuid}/items/{cartItemUuid}/participants/schema' \
-H 'X-Musement-Application: {applicationValue}' \
-H 'X-Musement-Version: 3.4.0' \
-H 'Authorization: Bearer {accessToken}'

Cart items with participant info will return a JSON schema in the response:

Copy

Copied

{
	"title": "cart_item_participants_info",
	"type": "object",
	"properties": {
		"participants": {
			"type": "array",
			"title": "participants",
			"items": {
				"title": "prototype",
				"type": "object",
				"properties": {
					"firstname": {
						"type": "string",
						"title": "Nome",
						"propertyOrder": 1
					},
					"lastname": {
						"type": "string",
						"title": "Cognome",
						"propertyOrder": 2
					}
				},
				"required": [
					"firstname",
					"lastname"
				]
			},
			"minItems": 2,
			"maxItems": 2,
			"propertyOrder": 1
		}
	},
	"required": [
		"participants"
	]
}

In the example above, the firstname and lastname properties are required for each participant in the booking. So if a cart item contains a quantity of two, then two sets of first and last names must be collected.

If the response returns a 404 status code, no participant info is required for the cart item.

You can submit participant info for a cart item by making the following request:

Copy

Copied

curl -X PUT '{baseUrl}/carts/{cartUuid}/items/{cartItemUuid}/participants' \
-H 'X-Musement-Application: {applicationValue}' \
-H 'X-Musement-Version: 3.4.0' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
--data-raw '[
	{
		"phone_number": "123456789"
	},
	{
		"phone_number": "987654321"
	}
]'