Developer portal

Inventory API

Get Event information

Get Events

GET /Events

Returns all LIVE Events

Request

URI
GET https://api.londontheatredirect.com/rest/v2/Events
Request Headers
Api-Key: [YOUR API KEY]
Content-Type: application/json
Variables

No variables required

Response

Name Data type Additional information
Events Collection of EventInfo information about event (e.g. The Lion King, ...) 

{
  "Events": [
    {
      "EventId": 9,
      "EventType": 1,
      "Name": "The Lion King",
      "Description": "<p>Set against the majesty of the Serengeti Plains to the evocative rhythms of Africa, this spectacular production...</p>\r\n",
      "VenueId": 9,
      "RunningTime": "2 hours 30 minutes",
      "AgeRating": 3,
      "MinimumAge": "Please note: Children under 3 years of age are not permitted to the Lyceum Theatre.  Recommended age 6+, parents may be asked to control or remove persistently noisy or rowdy children",
      "ImportantNotice": "Children under 3 years of age will not be admitted... ",
      "MainImageUrl": "https://media.londontheatredirect.com/Event/TheLionKing/event-list-image_45255.jpg",
      "SmallImageUrl": "https://media.londontheatredirect.com/Event/TheLionKing/event-list-image_45255.jpg",
      "DetailImageUrl": "https://media.londontheatredirect.com/Event/TheLionKing/event-hero-image_45256.jpg",
      "SpecialGraphics": "1",
      "OfferLabel": "Offer",
      "ShortOfferText": "",
      "LongOfferText": "<p> </p>\r\n\r\n<p> </p>\r\n",
      "CurrentPrice": 0,
      "OfferPrice": 0,
      "StartDate": "2015-01-01T14:30:00",
      "EndDate": "2017-07-09T14:30:00",
      "EventMinimumPrice": 35,
      "Images": [
        {
          "Width": 504,
          "Height": 336,
          "Url": "https://media.londontheatredirect.com/Event/TheLionKing/The-Lion-King-6828.jpg"
        }
		...
      ],
      "MultimediaContent": [
        {
          "Type": 0,
          "Url": "https://www.youtube.com/embed/e0TK1zfGV_U?autoplay=true"
        }
		...
      ],
      "EventDetailUrl": "https://www.ltdtickets.com/musical/9/The-Lion-King-tickets.aspx",
      "TagLine": "Disney’s award-winning musical, now in its 16th year at London’s Lyceum Theatre",
      "PrintAtHomeTicketsEnabled": true,
      "Accessibility": null,
      "ContentWarnings": null
    },
	{
      "EventId": 1017,
      "EventType": 1,
      "Name": "Mamma Mia!",
      "Description": "<p>Set on a Greek island paradise, a story of love, friendship and identity is cleverly told through the timeless songs of ABBA...</p>\r\n",
      "VenueId": 76,
      "RunningTime": "2 hours 35 minutes including interval",
      "AgeRating": 5,
      "MinimumAge": "5+",
      "ImportantNotice": "Monday to Saturday at 7.45pm. Thursday and Saturday at 3pm",
      "MainImageUrl": "https://media.londontheatredirect.com/Event/MAMMAMIA/event-list-image_47334.jpg",
      "SmallImageUrl": "https://media.londontheatredirect.com/Event/MAMMAMIA/event-list-image_47334.jpg",
      "DetailImageUrl": "https://media.londontheatredirect.com/Event/MAMMAMIA/event-hero-image_47337.jpg",
      "SpecialGraphics": "1",
      "OfferLabel": "Offer",
      "ShortOfferText": "",
      "LongOfferText": "<p> </p>\r\n\r\n<p> </p>\r\n\r\n<p> </p>\r\n",
      "CurrentPrice": 0,
      "OfferPrice": 0,
      "StartDate": "2015-01-01T19:45:00",
      "EndDate": "2017-10-14T19:45:00",
      "EventMinimumPrice": 18,
      "Images": [
        {
          "Width": 801,
          "Height": 534,
          "Url": "https://media.londontheatredirect.com/Event/MAMMAMIA/event-gallery-image_44299.jpg"
        }
		...
      ],
      "MultimediaContent": [
        {
          "Type": 0,
          "Url": "https://www.youtube.com/embed/S2B2ml7i4ts?autoplay=true"
        }
      ],
      "EventDetailUrl": "https://www.ltdtickets.com/musical/1017/Mamma-Mia--tickets.aspx",
      "TagLine": "Join the ultimate feel-good party at the world’s sunniest and most exhilarating smash-hit musical!",
      "PrintAtHomeTicketsEnabled": false,
      "Accessibility": "For wheelchair and access tickets to the Lyceum Theatre please call ...",
      "ContentWarnings": "Disney's The Lion King at the Lyceum Theatre contains smoke and fog effects as well as strobe lighting."
    }
	...
  ]
}

Get Events by Type

GET /Events?type={eventTypeId}

Returns all LIVE events of provided type. See EventType enumeration definition for possible values.

Request

URI
GET https://api.londontheatredirect.com/rest/v2/Events?type={eventTypeId}
Request Headers
Api-Key: [YOUR API KEY]
Content-Type: application/json
Variables
Variable Requirement Data type Example Additional information
EventTypeId required Integer 1 event type identifier

Response

Name Data type Additional information
Events Collection of EventInfo information about event (e.g. The Lion King, ...) 
{
  "Events": [
    {
      "EventId": 2228,
      "EventType": 2,
      "Name": "Lady Day At Emerson's Bar & Grill",
      "Description": "<p>1959, in a small, intimate bar in Philadelphia, Holiday puts on...</p>\r\n",
      "VenueId": 27,
      "RunningTime": "TBC",
      "AgeRating": null,
      "MinimumAge": "",
      "ImportantNotice": "",
      "MainImageUrl": "https://media.londontheatredirect.com/Event/LadyDayAtEmersonsBarGrill/Lady-Day-At-Emersons-Bar-Grill-8170.jpg",
      "SmallImageUrl": "https://media.londontheatredirect.com/Event/LadyDayAtEmersonsBarGrill/Lady-Day-At-Emersons-Bar-Grill-8170.jpg",
      "DetailImageUrl": "https://media.londontheatredirect.com/Event/LadyDayAtEmersonsBarGrill/Lady-Day-At-Emersons-Bar-Grill-8175.jpg",
      "SpecialGraphics": "1",
      "OfferLabel": "Offer",
      "ShortOfferText": "",
      "LongOfferText": "",
      "CurrentPrice": 0,
      "OfferPrice": 0,
      "StartDate": "2017-06-17T19:45:00",
      "EndDate": "2017-09-09T19:45:00",
      "EventMinimumPrice": 0,
      "Images": [
        {
          "Width": 3960,
          "Height": 2640,
          "Url": "https://media.londontheatredirect.com/Event/LadyDayAtEmersonsBarGrill/Lady-Day-At-Emersons-Bar-Grill-8174.jpg"
        }
		...
      ],
      "MultimediaContent": [],
      "EventDetailUrl": "https://www.ltdtickets.com/play/2228/Lady-Day-At-Emerson-s-Bar---Grill-tickets.aspx",
      "TagLine": "“Mesmerizing! Pouring her heart into her voice, Audra McDonald breathes life into Billie Holiday’s greatest songs.”  The New York Times",
      "PrintAtHomeTicketsEnabled": false,
      "Accessibility": null,
      "ContentWarnings": null
    },
    {
      "EventId": 2536,
      "EventType": 2,
      "Name": "Don Juan in Soho starring David Tennant",
      "Description": "<p><em>“Please don’t be charmed, he’s not a lovable rogue...”</em></p></p>\r\n",
      "VenueId": 27,
      "RunningTime": "TBC",
      "AgeRating": 16,
      "MinimumAge": "16+",
      "ImportantNotice": " Contains scenes of sexual nature. Contains strong language. ",
      "MainImageUrl": "https://media.londontheatredirect.com/Event/DonJuaninSohostarringDavidTennant/Don-Juan-in-Soho-starring-David-Tennant-10788.jpg",
      "SmallImageUrl": "https://media.londontheatredirect.com/Event/DonJuaninSohostarringDavidTennant/Don-Juan-in-Soho-starring-David-Tennant-10788.jpg",
      "DetailImageUrl": "https://media.londontheatredirect.com/Event/DonJuaninSohostarringDavidTennant/Don-Juan-in-Soho-starring-David-Tennant-10797.jpg",
      "SpecialGraphics": "1",
      "OfferLabel": "Offer",
      "ShortOfferText": "",
      "LongOfferText": "",
      "CurrentPrice": 0,
      "OfferPrice": 0,
      "StartDate": "2017-03-17T19:30:00",
      "EndDate": "2017-06-10T19:30:00",
      "EventMinimumPrice": 0,
      "Images": [
        {
          "Width": 600,
          "Height": 365,
          "Url": "https://media.londontheatredirect.com/Event/DonJuaninSohostarringDavidTennant/Don-Juan-in-Soho-starring-David-Tennant-10787.jpg"
        }
		...
      ],
      "MultimediaContent": [
        {
          "Type": 0,
          "Url": "https://youtu.be/hsv130q9OvQ"
        }
      ],
      "EventDetailUrl": "https://www.ltdtickets.com/play/2536/Don-Juan-in-Soho-starring-David-Tennant-tickets.aspx",
      "TagLine": "David Tennant stars in Don Juan in Soho for a strictly limited run at London's Wyndhams Theatre",
      "PrintAtHomeTicketsEnabled": false,
      "Accessibility": null,
      "ContentWarnings": null
    }
	...
  ]
}

Get Event detail

GET /Events/{eventId}

Returns information about specified event

Request

URI
GET https://api.londontheatredirect.com/rest/v2/Events/{eventId}
Request Headers
Api-Key: [YOUR API KEY]
Content-Type: application/json
Variables
Variable Requirement Data type Example Additional information
EventId required Integer 9 event identifier

Response

Name Data type Additional information
Event EventInfo information about event (e.g. The Lion King, ...) 
{
    "Event": {
        "EventId": 9,
        "EventType": 1,
        "Name": "The Lion King",
        "Description": "Set against the majesty of the Serengeti Plains to the evocative rhythms of Africa, this spectacular production explodes with glorious colours, stunning effects...",
        "VenueId": 9,
        "RunningTime": "2 hours 30 minutes",
        "AgeRating": 3,
        "MinimumAge": "Please note: Children under 3 years of age are not permitted to the Lyceum Theatre.  Recommended age 6+, parents may be asked to control or remove persistently noisy or rowdy children",
        "ImportantNotice": "Children under 3 years of age will not be admitted to performances of Disney's The Lion King at the Lyceum Theatre and all children under the age of 16 must be accompanied by an adult. Recommended age 6+, parents may be asked to control or remove persistently noisy or rowdy children.\r\n\r\nStrobe lighting is used several times during the performance.\r\nPlease note, we sell tickets for the LONDON production of the show.\r\nThe seats offered on our website do not include access for patrons using wheelchairs. Please call 0845 505 8500 for wheelchair access. ",
        "MainImageUrl": "https://media.londontheatredirect.com/Event/TheLionKing/event-list-image_45255.jpg",
        "SmallImageUrl": "https://media.londontheatredirect.com/Event/TheLionKing/event-list-image_45255.jpg",
        "DetailImageUrl": "https://media.londontheatredirect.com/Event/TheLionKing/event-hero-image_45256.jpg",
        "SpecialGraphics": "1",
        "OfferLabel": "Offer",
        "ShortOfferText": "",
        "LongOfferText": " > ",
        "CurrentPrice": 0,
        "OfferPrice": 0,
        "StartDate": "2015-01-01T14:30:00",
        "EndDate": "2017-07-09T14:30:00",
        "EventMinimumPrice": 35,
        "Images": [
            {
                "Width": 504,
                "Height": 336,
                "Url": "https://media.londontheatredirect.com/Event/TheLionKing/The-Lion-King-6828.jpg"
            },
            ...
        ],
        "MultimediaContent": [
            {
                "Type": 0,
                "Url": "https://www.youtube.com/embed/e0TK1zfGV_U?autoplay=true"
            },
            ...
        ],
        "EventDetailUrl": "https://www.ltdtickets.com/musical/9/The-Lion-King-tickets.aspx",
        "TagLine": "Disney’s award-winning musical, now in its 16th year at London’s Lyceum Theatre",
        "PrintAtHomeTicketsEnabled": true,
        "SeatingPlanSupported": true,
        "EventSeriesIds": [],
        "Accessibility": "For wheelchair and access tickets to the Lyceum Theatre please call ...",
        "ContentWarnings": "Disney's The Lion King at the Lyceum Theatre contains smoke and fog effects as well as strobe lighting.",
        "Cast": [
            {
                "Name": "John Doe",
                "Description": "Actor description",
                "Nationality": "London, England",
                "ActorUrlPath": "john-doe",
                "Image": {
                    "Width": 80,
                    "Height": 80,
                    "Url": "https://www.londontheatredirect.com/Static/Images/ltd-logo.png"
                },
                "BirthDate": null,
                "ExternalLinks": [
                    {
                        "ExternalLinkType": "Facebook",
                        "Link": "https://www.facebook.com/",
                        "DisplayTitle": "Facebook"
                    },
                    {
                        "ExternalLinkType": "Website",
                        "Link": "https://www.example.com/",
                        "DisplayTitle": "Official Website"
                    },
                    {
                        "ExternalLinkType": "Twitter",
                        "Link": "https://twitter.com/",
                        "DisplayTitle": "@johndoe"
                    },
                    {
                        "ExternalLinkType": "Instagram",
                        "Link": "https://www.instagram.com/",
                        "DisplayTitle": "Instagram"
                    },
                    {
                        "ExternalLinkType": "LinkedIn",
                        "Link": "https://uk.linkedin.com/",
                        "DisplayTitle": "LinkedIn"
                    },
                    {
                        "ExternalLinkType": "YouTube",
                        "Link": "https://www.youtube.com/",
                        "DisplayTitle": "YouTube"
                    }
                ]
            },
            ...
        ]
    }
}

Exceptions

HTTP Status Code Additional information
404 Show is no longer available due to setup changes

Get Event Performances

GET Events/{eventId}/Performances?dateFrom={dateFrom}&dateTo={dateTo}&minimumTicketsCount={minimumTicketsCount}

Returns performances for a specified event satisfying date range and minimum tickets count if provided

Request

URI
GET https://api.londontheatredirect.com/rest/v2/Events/{eventId}/Performances?dateFrom={dateFrom}&dateTo={dateTo}&minimumTicketsCount={minimumTicketsCount}
Request Headers
Api-Key: [YOUR API KEY]
Content-Type: application/json
Variables
Variable Requirement Data type Example Additional information
EventId required Integer 9 event identifier
DateFrom optional DateTime 2025-05-25 minimal acceptable date and time of any performance’s occurrence
DateTo optional DateTime 2025-05-30 maximal acceptable date and time of any performance’s occurrence
MinimumTicketsCount optional Integer 2 minimal required total available tickets count

Response

Name Data type Additional information
EventId Integer event identifier
Performances Collection of PerformanceInfo contains information about a performance
Note:

Performances that are not directly bookable are automatically added to the basket with tickets from the paired performance

{
  "EventId": 9,
  "Performances": [
    {
      "PerformanceId": 338153,
      "PerformanceDate": "2017-02-21T19:30:00",
      "TicketCount": 10,
      "TotalSeatsCount": 158,
      "TotalAvailableTickesCount": 87,
      "ContainsDiscountOfferTickets": false,
      "ContainsNoFeeOfferTickets": false,
      "MinimumTicketPrice": 0,
      "MaximumConsecutiveSeatsCount": 12,
      "EventId": 9,
      "PairedPerformances": [338154],
      "DirectlyBookablePerformance": true
    },
    {
      "PerformanceId": 338154,
      "PerformanceDate": "2017-02-22T14:30:00",
      "TicketCount": 10,
      "TotalSeatsCount": 158,
      "TotalAvailableTickesCount": 57,
      "ContainsDiscountOfferTickets": false,
      "ContainsNoFeeOfferTickets": false,
      "MinimumTicketPrice": 0,
      "MaximumConsecutiveSeatsCount": 10,
      "EventId": 9,      
      "PairedPerformances": [338153],
      "DirectlyBookablePerformance": false
    },
    {
      "PerformanceId": 338155,
      "PerformanceDate": "2017-02-22T19:30:00",
      "TicketCount": 10,
      "TotalSeatsCount": 158,
      "TotalAvailableTickesCount": 139,
      "ContainsDiscountOfferTickets": false,
      "ContainsNoFeeOfferTickets": false,
      "MinimumTicketPrice": 0,
      "MaximumConsecutiveSeatsCount": 8,
      "EventId": 9,
      "PairedPerformances": null,
      "DirectlyBookablePerformance": true
    }
	...
  ]
}

Get Preliminary Booking information

GET /Events/{eventId}/PreliminaryBookingInfo

Returns a preliminary booking information of all performances for a specified event. Requires number of tickets requested to properly return minimum and maximum ticket price

Request

URI
GET https://api.londontheatredirect.com/rest/v2/Events/{eventId}/PreliminaryBookingInfo?dateFrom={dateFrom}&dateTo={dateTo}&nbOfTickets={nbOfTickets}&consecutiveSeatsOnly={consecutiveSeatsOnly}
Request Headers
Api-Key: [YOUR API KEY]
Content-Type: application/json
Variables
Variable Requirement Data type Example Additional information
EventId required Integer 9 event identifier
DateFrom required DateTime 2017-02-24 minimal valid date and time of performances
DateTo required DateTime 2017-02-28 maximal valid date and time of performances
NbOfTickets required Integer 2 maximal valid date and time of performances
ConsecutiveSeatsOnly required Boolean true flag indicating whether you are interested only in immediately consecutive seats

Response

Name Data type Additional information
Performances Collection of PreliminaryPerformanceInfo preliminary performance information 
{
  "Performances": [
    {
      "PerformanceId": 338153,
      "PerformanceDate": "2017-02-21T19:30:00",
      "MinimalTicketPrice": 105,
      "MaximalTicketPrice": 150
    },
    {
      "PerformanceId": 338154,
      "PerformanceDate": "2017-02-22T14:30:00",
      "MinimalTicketPrice": 57.5,
      "MaximalTicketPrice": 150
    },
    {
      "PerformanceId": 338155,
      "PerformanceDate": "2017-02-22T19:30:00",
      "MinimalTicketPrice": 105,
      "MaximalTicketPrice": 150
    },
    {
      "PerformanceId": 338156,
      "PerformanceDate": "2017-02-23T19:30:00",
      "MinimalTicketPrice": 47.5,
      "MaximalTicketPrice": 150
    }
  ]
}

Get Event Reviews

GET Events/{eventId}/Reviews

Returns reviews for a specified event. By default it returns 10 reviews ordered by created datetime descending

Request

URI
GET https://api.londontheatredirect.com/rest/v2/Events/{eventId}/Reviews?order={reviewsOrder}&count={nbOfReviews}&from={nbFrom}
Request Headers
Api-Key: [YOUR API KEY]
Content-Type: application/json
Variables
Variable Requirement Data type Example Additional information
EventId required Integer 9 event identifier
ReviewsOrder not required Integer 2 Enum ReviewsOrder (0 - DateDescending is set by default)
NbOfReviews not required Integer 20 count of reviews returned (10 is set by default)
NbFrom not required Integer 20 count of reviews skipped (0 is set by default)

Response

Name Data type Additional information
Reviews Collection of Review contains information about a review
ReviewsCount Integer reviews count
AverageRating Decimal number average rating
HighestPossibleRating Integer highest possible rating
CurrentReviewsCount Integer selected reviews count
CurrentReviewsFrom Integer selected reviews skipped 
{
  "Reviews": [
    {
      "ConsumerName": "Di Virgin",
      "Stars": 5,
      "CreatedAt": "2017-02-05T17:25:20.87",
      "Content": "what an amazing show, it gave me goosebumps"
    },
    {
      "ConsumerName": "Emily Whiteley",
      "Stars": 5,
      "CreatedAt": "2017-02-05T10:47:00.527",
      "Content": "This production was amazing. I couldn't get over how much the stage moves through each scene! I took my 8 year old daughter to see this and she was in awe. It is definately one u would see again"
    },
    {
      "ConsumerName": "James Matthews",
      "Stars": 5,
      "CreatedAt": "2017-02-05T10:27:31.27",
      "Content": "We took our 2 teenage granddaughters to see this show and we all thoroughly enjoyed it. The girls were wowed. It was absolutely brilliant and a great afternoon."
    }
  ],
  "ReviewsCount": 3043,
  "AverageRating": 4.7,
  "HighestPossibleRating": 5,
  "CurrentReviewsCount": 3,
  "CurrentReviewsFrom": 0
}