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"
}
}
}