Data Types
Complex data types
EventInfo
Information about event (e.g. The Lion King, The Phantom of The Opera, ...)
| Property | Data type | Nullable | Description |
|---|---|---|---|
| EventId | Integer | no | event identifier |
| EventType | Integer (type id) | no | see EventType enumeration for further information |
| Name | String | no | event name |
| Description | String | yes | HTML-formatted description |
| VenueId | Integer | no | id of a venue where event is being played |
| RunningTime | string | yes | length of the event |
| AgeRating | Integer | yes | minimal age required to attend the event |
| MinimumAge | string | yes | minimal age policy description |
| ImportantNotice | string | yes | notice for the event |
| MainImageUrl | String | yes | URL to a very default illustration image |
| SmallImageUrl | String | yes | URL to a small illustration image |
| DetailImageUrl | String | yes | URL to a larger illustration image, suitable for event detail page |
| SpecialGraphics | String | yes | id of extra graphics (see SpecialGraphics enumeration for further information) |
| OfferLabel | String | yes | Label with possible price offer |
| ShortOfferText | String | yes | text with possible price offer |
| LongOfferText | String | yes | long text with possible price offer |
| CurrentPrice | Decimal | no | common/current price |
| OfferPrice | Decimal | no | offer price for offer tickets |
| StartDate | DateTime | yes | date and time of the first performance |
| EndDate | DateTime | yes | date and time of the last performance |
| EventMinimumPrice | Decimal | no | lowest ticket price for event |
| EventMaximumPrice | Decimal | no | highest ticket price for event |
| OfferDisplayText | String | yes | offer display text for the event |
| Images | list of Image | no | List of the gallery images of the show (this property is only available in the Get Event detail endpoint response) |
| MultimediaContent | list of EventMultimediaContent | no | List of the attached multimedia resources of the show (this property is only available in the Get Event detail endpoint response) |
| EventDetailUrl | String | yes | event detail URL address |
| TagLine | String | yes | short description tag |
| PrintAtHomeTicketsEnabled | Boolean | no | if PrintAtHomeTickets are available for this event |
| SeatingPlanSupported | Boolean | no | if Seating plan is available for this event |
| EventSeriesIds | list of Integers | no | list of event series |
| Accessibility | string | yes | Venue accessibility information |
| ContentWarnings | string | yes | Content warnings of the show |
| Cast | Collection of ActorInfo | no | List of the cast of the show (this property is only available in the Get Event detail endpoint response) |
GetEventListResult
| Property | Data type | Nullable | Description |
|---|---|---|---|
| Events | Collection of EventInfo | no | contains information about an event |
GetEventDetailResult
| Property | Data type | Nullable | Description |
|---|---|---|---|
| Event | EventInfo | no | contains information about an event |
AvailableEventInfo
| Property | Data type | Nullable | Description |
|---|---|---|---|
| EventName | String | yes | event name |
| EventId | Integer | no | event identifier |
| AvailablePerformanceInfos | Collection of AvailablePerformanceInfo | no | contains information about an available performance |
GetEventPreliminaryBookingInfoResult
| Property | Data type | Nullable | Description |
|---|---|---|---|
| Performances | Collection of PreliminaryPerformanceInfo | no | contains preliminary information about a performance |
VenueInfo
Information about venue
| Property | Data type | Nullable | Description |
|---|---|---|---|
| VenueId | Integer | no | venue identifier |
| Name | String | yes | venue name |
| Info | String | yes | HTML-formatted description |
| Address | String | yes | street, house number |
| City | String | yes | city |
| Postcode | String | yes | postal code |
| Telephone | String | yes | phone number |
| Fax | String | yes | fax number |
| String | yes | e-mail address | |
| NearestTube | String | yes | name of the nearest tube if any |
| Train | String | yes | name of the nearest train station if any |
| PlanLink | String | yes | URL to an image that illustrates a seating plan |
| ImageUrl | String | yes | URL to an image that contains a building picture |
GetVenuesResult
| Property | Data type | Nullable | Description |
|---|---|---|---|
| Venues | Collection of VenueInfo | no | contains information about a venue |
GetVenueDetailResult
| Property | Data type | Nullable | Description |
|---|---|---|---|
| Venue | VenueInfo | no | contains information about a venue |
PerformanceInfo
Contains information about a performance
| Property | Data type | Nullable | Description |
|---|---|---|---|
| PerformanceId | Integer | no | performance identifier |
| PerformanceDate | DateTime | no | date and time at which performance occurs |
| TicketCount | Integer | no | maximum count of tickets that can be sold |
| TotalSeatsCount | Integer | yes | total seats count for the performance |
| TotalAvailableTickesCount | Integer | no | total tickets available |
| ContainsDiscountOfferTickets | Boolean | no | flag indicating whether there are any discount offer tickets (i.e. selling price < face price) |
| ContainsNoFeeOfferTickets | Boolean | no | flag indicating whether there are any no fee tickets (i.e. face price = selling price) |
| MinimumTicketPrice | Decimal | no | the lowest ticket price |
| MaximumTicketPrice | Decimal | no | the highest ticket price |
| OfferDisplayText | String | no | Text for offer on the performance |
| MaximumConsecutiveSeatsCount | Integer | no | maximum count of tickets that are consecutive |
| PairedPerformances | Collection of Integers | yes | collection of related performance ids |
| DirectlyBookablePerformance | Boolean | no | indicates that performance can be added to basket |
EventPerformances
| Property | Data type | Nullable | Description |
|---|---|---|---|
| EventId | Integer | no | event identifier |
| Performances | Collection of Performance | no | contains information about a performance |
Performance
| Property | Data type | Nullable | Description |
|---|---|---|---|
| PerformanceId | Integer | no | performance identifier |
| PerformanceDate | DateTime | no | date and time at which performance occurs |
| IsUnreserved | Boolean | no | if reservation for this performance is not required |
GetPerformanceDetailResult
| Property | Data type | Nullable | Description |
|---|---|---|---|
| Performance | PerformanceInfo | no | contains information about event performances |
GetPerformancesResult
| Property | Data type | Nullable | Description |
|---|---|---|---|
| Performances | Collection of PerformanceInfo | no | contains information about a performance |
GetEventPerformancesResult
| Property | Data type | Nullable | Description |
|---|---|---|---|
| EventId | Integer | no | event identifier |
| Performances | Collection of PerformanceInfo | no | contains information about a performance |
GetEventsPerformancesResult
| Property | Data type | Nullable | Description |
|---|---|---|---|
| Events | Collection of EventPerformances | no | contains information about event performances |
PreliminaryPerformanceInfo
| Property | Data type | Nullable | Description |
|---|---|---|---|
| PerformanceId | Integer | no | performance identifier |
| PerformanceDate | DateTime | no | date and time at which performance occurs |
| MinimalTicketPrice | Decimal | no | the lowest ticket price |
| MaximalTicketPrice | Decimal | no | the highest ticket price |
AvailablePerformanceInfo
| Property | Data type | Nullable | Description |
|---|---|---|---|
| PerformanceId | Integer | no | performance indentifier |
| PerformanceDate | DateTime | no | date and time at which performance occurs |
| MinimumTicketPrice | Decimal | no | the lowest ticket price |
| AvailableTicketInfos | Collection of AvailableTicketInfo | yes | contains information about a ticket that is available for sale |
| AvailableTicketsBlockInfos | Collection of AvailableTicketsBlockInfo | no | contains information about available tickets grouped by a ticket area, face and selling price |
GetAvailablePerformanceTicketsResult
| Property | Data type | Nullable | Description |
|---|---|---|---|
| PerformanceId | Integer | no | performance identifier |
| EventId | Integer | no | event identifier |
| TicketAreas | Collection of TicketAreaInfo | no | contains information about an available ticket in a seating area |
AvailableTicketInfo
Contains information about a ticket that is available for sale
| Property | Data type | Nullable | Description |
|---|---|---|---|
| VenueId | Integer | no | id of a venue where this event takes place |
| VenueName | String | yes | venue name |
| VenueAddress | String | yes | venue address |
| VenueCity | String | yes | venue city |
| TicketName1 | String | no | seat row |
| TicketName2 | String | no | seat number |
| AdjacencyIndex | Integer | no | marks seats adjacency |
| FaceValue | Decimal | no | face price |
| SellingPrice | Decimal | no | selling price |
| DirectBookingUrl | String | yes | booking URL; by calling this URL you get redirected to a booking page for a performance that this ticket belongs to; it also contains a placeholder {0} (number of required tickets) that you must replace with a real value before calling |
| TicketArea | String | yes | name of a ticket area where ticket resides (e.g. Stalls, Royal Circle) |
| TicketId | Integer | no | ticket identifier |
| IsRestrictedView | Bool | no | indicates, whether related ticket has restricted view |
| RestrictionDescription | String | yes | restricted view description (occurs only, when IsRestrictedView is set to true) |
AvailableTicketsBlockInfo
Serves as a group of available tickets grouped by a ticket area, face and selling price
| Property | Data type | Nullable | Description |
|---|---|---|---|
| AreaName | String | yes | ticket area name which this block refers to |
| FacePrice | Decimal | no | face price that is same for all tickets within this block |
| SellingPrice | Decimal | no | selling price that is same for all tickets within this block |
| AvailableTicketsInfos | Collection of AvailableTicketInfo | no | contains information about a ticket that is available for sale |
FullTicketInfo
Contains information about a ticket that is available for sale
| Property | Data type | Nullable | Description |
|---|---|---|---|
| TicketId | Integer | no | ticket identifier |
| AreaName | String | yes | ticket area name which this block refers to |
| TicketName1 | String | no | seat row |
| TicketName2 | String | no | seat number |
| SellingPrice | Decimal | no | selling price that is same for all tickets within this block |
| FaceValue | Decimal | no | face price |
| FullRetailPrice | Decimal | no | full price of the tickets within this block (note: this value will be 0 if the event settings do not allow the display of the original price) |
| RestrictedView | Bool | no | indicates, whether related ticket has restricted view |
| Description | String | yes | seat description (usually restricted view description) |
GetFullPerformanceAvailabilityResult
| Property | Data type | Nullable | Description |
|---|---|---|---|
| PerformanceId | Integer | no | performance identifier |
| EventId | Integer | no | event identifier |
| AvailableTickets | Collection of FullTicketInfo | no | contains information about a ticket that is available for sale |
CheckTicketAvailabilityResult
| Property | Data type | Nullable | Description |
|---|---|---|---|
| TicketId | Integer | no | ticket identifier |
| IsAvailable | bool | no | if this ticket is available |
GetEventAvailableTicketsResult
| Property | Data type | Nullable | Description |
|---|---|---|---|
| AvailableEvent | AvailableEventInfo | no | contains information about an available event |
GetEventsAvailableTicketsResult
| Property | Data type | Nullable | Description |
|---|---|---|---|
| AvailableEvents | Collection of AvailableEventInfo | no | contains information about an available event |