• Register

Theatre details

/theatres/:theatreId

Returns metadata for a single theatre, including address, phone, and coordinates.

Request Parameters

Parameter

Mandatory?

Description

theatreId

Yes

Resource identifier for theatre.
api_key Yes 24-character key obtained during application registration

Response Body

Response

Description

theatreId Resource identifier for theatre
name Theatre name
location Object containing the following:
distance Distance from zip/postal code center, or coordinates; given in units specified by 'units' parameter.
address Object containing the following:
street Street address, line 1
street2 Street address, line 2, if available
city City
state State abbreviation
postalCode Zip or postal code
country USA or CAN
telephone Telephone number, format XXX-XXX-XXXX
geoCode Object containing the following:
longitude Longitude coordinate of theatre
latitude Latitude coordinate of theatre

Sample Request

Return all theatres within 5 miles of US zipcode 60611.

http://data.tmsapi.com/v1.1/theatres/7719?api_key=1234567890

Sample Response

{
    "theatreId": "7719",
    "name": "Navy Pier IMAX Theatre",
    "location": {
        "telephone": "312-595-5629",
        "geoCode": {
            "latitude": "41.8921",
            "longitude": "-87.6088"
        },
        "address": {
            "street": "600 E. Grand Ave. Ste 115",
            "state": "IL",
            "city": "Chicago",
            "country": "USA",
            "postalCode": "60611"
        }
    }
}