# Experience

An Experience is the product a company offers — for example, a guided tour, a workshop, or a tasting.

Experiences are templates: each Experience produces one or more Events (scheduled instances) that customers actually book.
This API exposes experiences along with their information requests and ticket variants.


## Get experiences

 - [GET /v1/experiences](https://developer.understory.io/apis/experience/getexperiences.md): Get all experiences for the company.

Returns experiences in any non-deleted lifecycle state, including INACTIVE and ARCHIVED.
Filter by state client-side if you only want bookable experiences. The response is paginated;
pass the returned next cursor on subsequent calls to continue.

## Get experience

 - [GET /v1/experiences/{experienceId}](https://developer.understory.io/apis/experience/getexperiencebyid.md): Get an experience by its ID.

## Get information requests

 - [GET /v1/experiences/{experienceId}/information-requests](https://developer.understory.io/apis/experience/getinformationrequestsforexperience.md): Get the information requests configured for an experience.

Information requests describe the additional questions a guest answers during the booking flow.
Use them to render the booking form. The answers a guest actually provides are returned by
Get information request answers on a booking.

## Get ticket variants

 - [GET /v1/experiences/{experienceId}/ticket-variants](https://developer.understory.io/apis/experience/getticketvariantsforexperience.md): Get the ticket variants configured for an experience.

Ticket variants are the ticket options a guest can choose between when booking — the experience's
price catalog. Add-ons offered alongside a ticket are nested inside each variant. Pricing returned
here is the catalog price; the actual price for a specific event is finalized when the booking is created.

## Experience created

 - [POST v1.experience.created](https://developer.understory.io/apis/experience/experiencecreated.md): Sent when a new experience is created.

## Experience updated

 - [POST v1.experience.updated](https://developer.understory.io/apis/experience/experienceupdated.md): Sent when an experience is updated.

## Experience deleted

 - [POST v1.experience.deleted](https://developer.understory.io/apis/experience/experiencedeleted.md): Sent when an experience is deleted.

## Experience created

 - [POST v1.experience.created](https://developer.understory.io/apis/webhook/experiencecreated.md): Sent when a new experience is created.

## Experience updated

 - [POST v1.experience.updated](https://developer.understory.io/apis/webhook/experienceupdated.md): Sent when an experience is updated.

## Experience deleted

 - [POST v1.experience.deleted](https://developer.understory.io/apis/webhook/experiencedeleted.md): Sent when an experience is deleted.