Developer portal

Types

List of all webhooks types

Scheduled E-tickets Available

Sent when tickets with delivery type Scheduled E-tickets become available.

Details

Trigger

Triggered when scheduled date for scheduled e-tickets is in the past (see TicketInfoBooking and ScheduledOn field for reference)

Scope

Sent for every basket individually

Authentication

Please see Webhook Authentication for details

Payload

Name Data type Additional information
AffiliateId Guid Your unique partner identifier
BookingReference string Booking reference that this webhook was sent for
CustomerEmail string Email of the customer that placed the booking
Tickets Collection of AvailableScheduledEticketInfo Contains information about the tickets
{
    "MessageType":"ScheduledEticketDelivery",
    "Payload":{
        "AffiliateId": "281ffaaa-a70b-4cd2-a401-9e50b00a1204",
        "BookingReference": "ABC01599",
        "CustomerEmail": "[email protected]",
        "Tickets": [
            {
                "EventName": "Christmas Actually",
                "PerformanceDate": "2023-12-07T19:30:00",
                "TicketName1": "N",
                "TicketName2": 40,
                "AreaName": "Balcony",
                "VenueName": "Royal Festival Hall, Southbank Centre",
                "Barcode": "00000015125182882200",
                "BarcodeType": "QRCode"
            },
            {
                "EventName": "Christmas Actually",
                "PerformanceDate": "2023-12-07T19:30:00",
                "TicketName1": "N",
                "TicketName2": 39,
                "AreaName": "Balcony",
                "VenueName": "Royal Festival Hall, Southbank Centre",
                "Barcode": "00000015125182882200",
                "BarcodeType": "QRCode"
            },
            {
                "EventName": "Christmas Actually",
                "PerformanceDate": "2023-12-07T19:30:00",
                "TicketName1": "N",
                "TicketName2": 38,
                "AreaName": "Balcony",
                "VenueName": "Royal Festival Hall, Southbank Centre",
                "Barcode": "00000015125182882200",
                "BarcodeType": "QRCode"
            }
    ]},
  "Timestamp": "2024-03-05T08:26:11.1451352Z"
}

Transaction changed

Sent when transaction is changed or created. Can be used to react to ticket cancellations, change of delivery informations or to other changes on transaction.

Details

Trigger

Triggered when transaction is changed or created.

Scope

Sent for every transaction individually

Authentication

Please see Webhook Authentication for details

Payload

Name Data type Additional information
BookingReference string Booking reference that this webhook was sent for
BasketId Guid Basket ID
DeliveryType enum Enum type of DeliveryType
TotalAmount decimal Total booking price
TotalCount int Number of tickets
Customer Type of Customer Contains information about the customer
PurchaseDateTime DateTime Date and time of purchase
Orders Collection of OrderTicketResponse Contains information about the tickets
{
    "MessageType": "TransactionChanged",
    "Payload": {
        "BookingReference": "CSK46133",
        "BasketId": "33de23ee-5e42-4aba-b941-6546e57fec28",
        "DeliveryType": "PrintAtHomeTickets",
        "TotalAmount": 108,
        "TotalCount": 1,
        "Customer": {
            "FullName": "Morgan Better",
            "Email": "[email protected]",
            "PhoneNumber": "1234657",
            "Address": {
                "AddressLine1": "",
                "AddressLine2": "",
                "AddressLine3": null,
                "AddressLine4": null,
                "City": "",
                "Country": "GB",
                "PostCode": ""
            }
        },
        "PurchaseDateTime": "2023-11-09T09:47:59.623",
        "Orders": [
            {
                "EventId": 3868,
                "EventImageUrl": "https://media.londontheatredirect.com/Event/FrozenTheMusical/event-detail-image_36364.jpg
                "PerformanceId": 661132,
                "PerformanceDateTime": "2024-03-17T13:00:00",
                "VenueName": "Theatre Royal Drury Lane",
                "VenueId": 11,
                "EventName": "Frozen The Musical",
                "Tickets": [
                    {
                        "SeatInfo": "E15",
                        "Barcode": "23017425",
                        "BarcodeType": "QRCode",
                        "AreaName": "Stalls",
                        "Price": 84,
                        "Status": "Purchased"
                    },
                    {
                        "SeatInfo": "J7",
                        "Barcode": "23017426",
                        "BarcodeType": "QRCode",
                        "AreaName": "Stalls",
                        "Price": 84,
                        "Status": "Cancelled"
                    }
                ],
                "OrderStatus": "Cancelled",
                "VenueLongitude": -0.142429,
                "VenueLatitude": 51.495739
            }
        ]
    },
    "Timestamp": "2024-03-05T08:26:11.1451352Z"
}

Performance changed

Sent when performance data is changed or created. Can be used to react to tickets avaliablity or change of prices.

Details

Trigger

Triggered when performance data is changed or created.

Scope

Sent for every performance individually

Authentication

Please see Webhook Authentication for details

Payload

Name Data type Additional information
EventId int Event ID
PerformanceId int Perfromance ID
HasOffer bool Indicates, if there is discount offer on this performance
PerformanceDateTime DateTime Date and time of the Performance
IsDisabled bool Flag indicating disabled performance. Disabled performances are not available for booking.
TotalSeatsCount int Number of total seats
TotalAvailableTicketsCount int Number of available tickets
Tickets Collection of Ticket Contains information about tickets
Prices Collection of Price Contains information about prices
Attributes Collection of Attribute Contains information about seat attributes
{
    "MessageType": "PerformanceChanged",
    "Payload": {
        "EventId": 2589,
        "PerformanceId": 688971,
        "HasOffer": false,
        "PerformanceDateTime": "2025-12-31T13:00:00",
        "TotalSeatsCount": 1000,
        "TotalAvailableTicketsCount": 900,
        "Tickets": [
            {
                "TicketId": 123456,
                "Row": "A",
                "Seat": 1,
                "AreaName": "Dress Circle",
                "SeatAttributeId": 1,
                "PriceId": 1
            }
        ],
        "Prices": [
            {
                "PriceId": 1,
                "FaceValue": 10,
                "SellingPrice": 15,
                "PriceBefore": 15
            }
        ],
        "Attributes": [
            {
                "AttributeId": 1,
                "RestrictedView": false,
                "Highlight": false,
                "Description": "Dress Circle"
            }
        ]
    },
    "Timestamp": "2024-05-14T08:26:11.1451352Z"
}

Event changed

Sent when event is changed or created. Can be used to update data related to events.

Details

Trigger

Triggered when event is changed or created.

Scope

Sent for every event individually

Authentication

Please see Webhook Authentication for details

Payload

Name Data type Additional information
EventId int Id of the changed event
UrlId string UrlId of the changed event
EventName string Name of the changed event
EventType enum Type of the changed event. See EventType enumeration for further information.
VenueName string Name of the venue where the event is happening
City string City where the event is happening
Address string Address where the event is happening
ReservedSeating bool Flag indicating whether the seating can be reserved via seating plan
PostCode string Post code of venue where the event is happening.
CustomerRating CustomerRating Customer ratting of the event
ThumbnailImage ImageLink Event Thumbnail image
VenueUrlId string UrlId of the Venue related to the event
EventMinimumPrice decimal? Minimal price of tickets for the event in £
TopOfferAmount decimal? Highest offer for the event in %
ClosestPerformanceDate DateTime? Date and time of performance closest to the occurrence of the webhook trigger
HasRelatedEvents bool Flag indicating whether the event has some related events

CustomerRating

Name Data type Additional information
Score double Average customer score
ReviewsCount int Number of reviews
Name Data type Additional information
AbsoluteUrl string Absolute url to the image
Description string Description of the image
{
    "MessageType": "EventChanged",    
    "Payload": {
        "EventId": 1234,
        "UrlId": "event-tickets",
        "EventName": "The Magic Event",
        "EventType": "Dance",
        "VenueName": "Sadler's Wells",
        "City": "London",
        "Address": "Rosebery Avenue, Islington",
        "ReservedSeating": true,
        "PostCode": "EC1R 4TN",
        "CustomerRating": {
            "Score": 5,
            "ReviewsCount": 100
        },
        "ThumbnailImage": {
            "AbsoluteUrl": "https://www.londontheatredirect.com/Static/Images/ltd-logo.png",
            "Description": "Magic event"
        },
        "VenueUrlId": "sadlers-wells-london",
        "EventMinimumPrice": null,
        "TopOfferAmount": null,
        "SalesChannels": {
            "IsEnabledBooking": false,
            "IsEnabledForLtdWebsite": true,
            "IsEnabledForWhiteLabels": false,
            "IsEnabledForApi": false,
            "AmazonPrimeOnly": false,
            "OnlyForSpecificAffiliates": false,
            "IsLive": false,
            "HotelPackage": null
        },
        "ClosestPerformanceDate": null,
        "HasRelatedEvents": false
    },
    "Timestamp": "2024-05-14T08:26:11.1451352Z"
}

Affiliate Opt-in

As part of the white-label solution, partners can define custom opt-ins during checkout. This webhook is triggered upon booking submission when a customer consents to a specific opt-in.

Details

Trigger

Triggered when customer completes purchase and agreed with specific affiliate Opt-in.

Scope

Sent for every Opt-in individually.

Authentication

Please see Webhook Authentication for details.

Payload

Name Data type Additional information
OptInText string Text displayed to customer
IsOptedIn bool Customer agreed with opt-in
Customer Customer Customer details
Booking Booking Booking details

Customer

Name Data type Additional information
FirstName string First name
LastName string Last name
Email string E-mail
Telephone string Phone number
Country string? Country

Booking

Name Data type Additional information
DeliveryTypeId int Id of type of delivery
BookingReference string? Public booking reference
DatePurchased DateTime? Date and time of the Purchase
TicketOrders Collection of TicketOrder Contains information about ticket orders
AdditionalOrders Collection of AdditionalOrder Contains information about additional orders such as vouchers

AdditionalOrder

Name Data type Additional information
Title string Title of additional order
BookingReference decimal? Price of additional order

TicketOrder

Name Data type Additional information
EventName string Name of event
PerformanceDate DateTime Date and time of the Performance
Category string? Category of the Event
Tickets Collection of Ticket Contains information about tickets

Ticket

Name Data type Additional information
Seat string Seat name
Price decimal Purchase price of the Ticket
{
  "MessageType": "AffiliateOptIn",
  "Payload": {
    "OptInText": "Receive updates and offers",
    "IsOptedIn": true,
    "Customer": {
      "FirstName": "John",
      "LastName": "Doe",
      "Email": "[email protected]",
      "Telephone": "123456789",
      "Country": "United Kingdom"
    },
    "Booking": {
      "DeliveryTypeId": 5,
      "BookingReference": "XYZ12345",
      "DatePurchased": "2025-04-01T10:00:00.753",
      "TicketOrders": [
        {
          "EventName": "Sample event",
          "PerformanceDate": "2025-10-01T18:00:00Z",
          "Category": "Musical",
          "Tickets": [
            {
              "Seat": "Z4",
              "Price": 150
            }
          ]
        }
      ],
      "AdditionalOrders": [
        {
          "Title": "Voucher",
          "Price": 10.00
        }
     ]
    }
  },
  "Timestamp": "2025-04-01T08:40:36.2103717Z"
}