Availability slots

Availability slots bring together all the components needed for a valid booking.

Creating an availability slot

Suppliers must use the POST /supplier/availability/experiences/{experience_id}/options/{option_id}/slots endpoint to create an availability slot for an experience. The exact body of the request changes based on the type of slot the experience needs.

Option

The option_id property must contain the ID of the option for the slot.

Available holder categories

Every slot must contain a list of holder categories that are available for the slot in the available_holder_categories property. Each item must correspond to one of the option's holder categories and include its price (in cents).

The min_quantity property for an available holder category indicates the minimum pax number which must be selected for a valid booking. The max_quantity property indicates the maximum possible pax number which can be selected. When a maximum is not specified, no limit is enforced.

Type

In addition to the properties described above, an availability slot will have additional properties depending on the availability_slot_type of the experience:

• Daily slot
• Open slot
• Time slot

Setting limits

The capacity property indicates the number of seats left for the availability slot. When the value is zero, the slot is no longer available. When this property is not provided, no seat limit is enforced.

Note that each pax number of holder categories in a booking will reduce the availability slot's remaining capacity. It is currently not possible to set a separate capacity for each holder category.

Specifying languages

The guide_languages property lists languages which can be booked for the option and slot. This property is optional and can be skipped if there is no language component. The value must match the ISO 639-1 standard.