Method name

GET cinemaDetails

Description

Returns the metadata for a single specific cinema, including name, address, logo

Example request

cinemaDetails/?cinema_id=12345

Notes

If you plan to provide a “Directions” service using Google Maps or similar, then we recommend you use the Latitude / Longitude of the cinema, rather than the postcode, as it will be more accurate in most cases.

Required headers

Sent header	Description	Data type	Optional / Mandatory
geolocation	Geolocation of end user, used to calculate distance of cinema from user. API cannot be cached if this option is used, which has a small affect on latency. Format must be lat;lon for example 51.510391;-0.13013	Latitude and Longitude	Optional

Sent Arguments

Sent argument	Description	Data type	Optional / Mandatory
cinema_id	The MovieGlu numeric internal cinema ID	Integer	Mandatory

Caching

The returned data can be cached. API cannot be cached if geolocation is sent in header.

Returned data

Returned Key	Description
cinema_id	The MovieGlu numeric internal cinema ID
cinema_name	The cinema name
address	Cinema address line 1
address2	Cinema address line 2 (where available)
city	Cinema city
county	Cinema county
country	Cinema country
postcode	Zip code or post code
phone	Phone number of cinema
lat	Cinema latitude
lng	Cinema longitude
distance	Distance in MILES from user’s geolocation (if provided in header)
ticketing	If true (1) then cinema offers movietickets.com affiliate ticketing scheme
directions	Directions to cinema
logo_url	Location of logo image for cinema (generally available for chains 4 or more cinemas, not all countries)
show_dates	Array – Dates when film is showing (useful for displaying a date selector for a cinema)
date	List of dates in format yyyy-mm-dd, when showtimes are available at selected cinema

Example response


{
  "cinema_id": 8795,
  "cinema_name": "ODEON Leicester Square",
  "address": "24-26 Leicester Square",
  "address2": "Westminster",
  "city": "London",
  "county": "Greater London",
  "country": "GBR",
  "postcode": "WC2H 7JY",
  "phone": "(0871) 224 4007",
  "lat": 51.510479,
  "lng": -0.12952,
  "distance": 69.091511207949,
  "ticketing": 0,
  "directions": "",
  "logo_url": "https://d2z9fe5yu2p0av.cloudfront.net/chainlogos/uk/UK-614-sq.jpg",
  "show_dates": [
    {
      "date": "2017-02-08"
    },
    {
      "date": "2017-02-09"
    },
    {
      "date": "2017-02-10"
    },
    {
      "date": "2017-02-11"
    },
    {
      "date": "2017-02-12"
    },
    {
      "date": "2017-02-13"
    },
    {
      "date": "2017-02-14"
    }
  ],
    "status": {
        "count": 1,
        "state": "OK",
        "method": "cinemaDetails",
        "message": null,
        "request_method": "GET",
        "version": "MGv200",
        "territory": "UK",
        "device_datetime_sent": "2018-09-14T14:03:40.979Z",
        "device_datetime_used": "2018-09-14 14:03:40"
  }
}