Options
Options are the bookable products of an experience. Each option carries its own schedule (slot configuration and availability period), pricing model (flat rate, per person, per group size, or duration based), variants, add-ons, extra booking fields, discounts and resource requirements. Options are managed under their experience at /v2/experiences/{experienceId}/options — reads are public; mutations are restricted to the experience's organizer and rejected on experiences whose availability is synced from an external provider (Bokun, Regiondo, Kompas). Deletions are soft deletes. The nested slots actions expose the full calendar for an option, including slots the guest-facing availability endpoints hide. The flat /v2/options surface is strictly read-only: it lists and retrieves options across experiences for the public booking flow.
Participant types (/v2/experiences/{experienceId}/participant-types) are the categories a guest can book: Adult, Child, Infant, plus organizer-defined custom types such as Senior or Student. Every experience is seeded with the three default types (isDefault: true), which can never be deleted and only have their age range edited. Custom types start disabled on every existing option — organizers enable them per option (and add a price, for per-person pricing) before they're bookable. isEnabledOnBookableOptions tells you whether at least one sellable option currently accepts the type.
Endpoints
- GET
/v2/experiences/{experienceId}/optionsList options of an experience - POST
/v2/experiences/{experienceId}/optionsCreate an option - GET
/v2/experiences/{experienceId}/options/{optionId}Retrieve an option - PUT
/v2/experiences/{experienceId}/options/{optionId}Update an option - DELETE
/v2/experiences/{experienceId}/options/{optionId}Delete an option - PATCH
/v2/experiences/{experienceId}/options/{optionId}Partially update an option - POST
/v2/experiences/{experienceId}/options/{optionId}/upload-ticketsUpload ticket codes for an option - GET
/v2/experiences/{experienceId}/options/{optionId}/slotsList calendar slots of an option - PATCH
/v2/experiences/{experienceId}/options/{optionId}/slots/{slotId}Update a calendar slot - POST
/v2/experiences/{experienceId}/options/{optionId}/slots/{slotId}/cancelCancel a slot and its live bookings - GET
/v2/experiences/{experienceId}/participant-typesList participant types of an experience - POST
/v2/experiences/{experienceId}/participant-typesCreate a custom participant type - GET
/v2/experiences/{experienceId}/participant-types/{participantTypeId}Retrieve a participant type - PUT
/v2/experiences/{experienceId}/participant-types/{participantTypeId}Update a participant type - DELETE
/v2/experiences/{experienceId}/participant-types/{participantTypeId}Delete a participant type - PATCH
/v2/experiences/{experienceId}/participant-types/{participantTypeId}Partially update a participant type - GET
/v2/optionsList options across experiences - GET
/v2/options/{optionId}Retrieve an option