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
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

ImageLink

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"
}