• Register

Theatres by postal code

/theatres

Returns a list of active US or Canadian theatres based on geographic information: US or Canadian postal code, or latitude/longitude coordinates.

Response data will be sorted by distance from requested location.

Request Parameters

Parameter

Mandatory?

Description

zip

No

Postal code (US or Canada)
Must supply either postal code or coordinates.
lat No Latitude; valid values are between -90 and 90.
Must supply either postal code or coordinates.
lng No Longitude; valid values are between -180 and 180.
Must supply either postal code or coordinates.
numTheatres No Maximum number of theatres to return in response. If not specified, response will include all theatres within specified radius.
radius No Range to search from initial location. Maximum is 100 mi (160 km).
Defaults to 5.
units No Unit of measurement for radius parameter. Valid values are mi or km. Defaults to miles.
Also specifies unit of measurement for distance field in response.
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 center of postal code, or distance from 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 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 78701.

http://data.tmsapi.com/v1.1/theatres?zip=78701&api_key=1234567890

Sample Response

[{
    "theatreId": "2469",
    "name": "Paramount Theatre",
    "location": {
        "distance": 0.146618,
        "telephone": "512-472-5470",
        "geoCode": {
            "latitude": "30.2691",
            "longitude": "-97.7423"
        },
        "address": {
            "street": "713 Congress Ave",
            "state": "TX",
            "city": "Austin",
            "country": "USA",
            "postalCode": "78701"
        }
    }
}, {
    "theatreId": "9489",
    "name": "Alamo Drafthouse at the Ritz",
    "location": {
        "distance": 0.283166,
        "telephone": "512-476-1320",
        "geoCode": {
            "latitude": "30.2673",
            "longitude": "-97.7401"
        },
        "address": {
            "street": "320 East 6th St.",
            "state": "TX",
            "city": "Austin",
            "country": "USA",
            "postalCode": "78701"
        }
    }
}, {
    "theatreId": "10420",
    "name": "Violet Crown Cinema",
    "location": {
        "distance": 0.548327,
        "telephone": "512-495-9600",
        "geoCode": {
            "latitude": "30.2653",
            "longitude": "-97.7479"
        },
        "address": {
            "street": "434 W. 2nd St",
            "state": "TX",
            "city": "Austin",
            "country": "USA",
            "postalCode": "78701"
        }
    }
}]