# Event

An Event is a scheduled, bookable instance of an Experience.

Each Event has a lifecycle state, a visibility, a capacity that is shared across all of its sessions,
and one or more Sessions describing when and where it takes place. Bookings are made against an Event.


## Get events

 - [GET /v1/events](https://developer.understory.io/apis/event/getevents.md): Get all events.

The response includes events in every non-deleted lifecycle state (ACTIVE, INACTIVE, CANCELLED, COMPLETED);
apply state filtering client-side if you only want bookable events.

## Get event

 - [GET /v1/events/{eventId}](https://developer.understory.io/apis/event/getevent.md): Get an event by its ID.

## Event created

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

## Event updated

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

## Event cancelled

 - [POST v1.event.cancelled](https://developer.understory.io/apis/event/eventcancelled.md): Sent when an event is cancelled.

## Event completed

 - [POST v1.event.completed](https://developer.understory.io/apis/event/eventcompleted.md): Sent when an event has completed.

For single-session events, this is triggered when the session's end time is reached.
For multi-session events, this is triggered when the last session's end time is reached.

## Event deleted

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

## Event created

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

## Event updated

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

## Event cancelled

 - [POST v1.event.cancelled](https://developer.understory.io/apis/webhook/eventcancelled.md): Sent when an event is cancelled.

## Event completed

 - [POST v1.event.completed](https://developer.understory.io/apis/webhook/eventcompleted.md): Sent when an event has completed.

For single-session events, this is triggered when the session's end time is reached.
For multi-session events, this is triggered when the last session's end time is reached.

## Event deleted

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