Movies
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
Code
Last modified on