Returns TV schedule information for all showings of a specific movie. Schedule information can be requested up to 14 days in advance, for a maximum period of 14 days after start date.
Response data will be sorted by airing dateTime. See Program metadata for listing of detailed movie metadata..
Request Parameters
Parameter
Mandatory?
Description
rootId
Yes
rootId, which can be retrieved by calling /programs API.
lineupId
Yes
LineupId, which can be retrieved by calling /lineups API.
startDateTime
Yes
DateTime to begin schedule information, specified in ISO 8601 format. Must be no more than 14 days after current dateTime.
endDateTime
No
DateTime to end schedule information, specified in ISO 8601 format. Must be no more than 14 days after startDateTime. If not specified, defaults to 3 hours after start dateTime.
includeDetail
No
Boolean (true/false) indicating whether to include program details with each airing. Defaults to false.
imageSize
No
Valid values are: Sm, Md, Lg, Ms. If not specified, defaults to Md (medium) If requested image size is not available, generic image will be returned.
imageText
No
Boolean indicating preference for image types with text (banners) or without text (iconics). If requested preference is not available, image selection will continue to next type (banner/iconic), before finally returning generic if no image found. Defaults to true for text preference.
descriptionLang
No
Filter movie airings based on the specified description language. Use IETF language tags (2-letter abbreviations, with optional 2-letter region extensions).
api_key
Yes
24-character key obtained during application registration
Response Body
Response
Type
Description
Movie airings
Airing [ ]
Schedule and program information for movie airings, up to a 24-hour period, on any station in specified lineup.
[{ "startTime": "2015-02-10T14:15Z", "endTime": "2015-02-10T16:15Z", "duration": 120, "qualifiers": ["CC"], "channels": ["598"], "program": { "tmsId": "MV004884770000", "rootId": "9991634", "subType": "Feature Film", "title": "Nebraska", "releaseYear": 2013, "releaseDate": "2013-05-22", "titleLang": "en", "descriptionLang": "en", "entityType": "Movie", "genres": ["Drama"], "longDescription": "Cantankerous old buzzard Woody Grant (Bruce Dern) can barely walk down the street of his home in Billings, Mont., without stopping for a drink. So when Woody receives receives a sweepstakes notice in the mail and insists on making a 750-mile trip to Lincoln, Neb., to collect his prize, it falls to baffled son David (Will Forte) to accompany him. During a stop in their Nebraska hometown, word gets out about Woody's fortune, first making him a hero, then later, the target of predatory people.", "shortDescription": "A man sets out on a road trip with his aging father to claim a cash prize that may not really exist.", "topCast": ["Bruce Dern", "Will Forte", "June Squibb"], "directors": ["Alexander Payne"], "qualityRating": { "ratingsBody": "TMS", "value": "3.5" }, "preferredImage": { "width": "240", "height": "360", "caption": { "content": "Nebraska (2013)", "lang": "en" }, "uri": "assets/p9991634_p_v5_aa.jpg", "category": "Poster Art", "text": "yes", "primary": "true" } }, "stationId": "74320", "station": { "stationId": "74320", "callSign": "EPIX3SD", "preferredImage": { "width": "360", "height": "270", "uri": "h3/NowShowing/74320/s74320_h3_aa.png", "category": "Logo", "primary": "true" }, "channel": "598" } }, { "startTime": "2015-02-10T20:50Z", "endTime": "2015-02-10T22:50Z", "duration": 120, "qualifiers": ["CC"], "channels": ["598"], "program": { "tmsId": "MV004884770000", "rootId": "9991634", "subType": "Feature Film", "title": "Nebraska", "releaseYear": 2013, "releaseDate": "2013-05-22", "titleLang": "en", "descriptionLang": "en", "entityType": "Movie", "genres": ["Drama"], "longDescription": "Cantankerous old buzzard Woody Grant (Bruce Dern) can barely walk down the street of his home in Billings, Mont., without stopping for a drink. So when Woody receives receives a sweepstakes notice in the mail and insists on making a 750-mile trip to Lincoln, Neb., to collect his prize, it falls to baffled son David (Will Forte) to accompany him. During a stop in their Nebraska hometown, word gets out about Woody's fortune, first making him a hero, then later, the target of predatory people.", "shortDescription": "A man sets out on a road trip with his aging father to claim a cash prize that may not really exist.", "topCast": ["Bruce Dern", "Will Forte", "June Squibb"], "directors": ["Alexander Payne"], "qualityRating": { "ratingsBody": "TMS", "value": "3.5" }, "preferredImage": { "width": "240", "height": "360", "caption": { "content": "Nebraska (2013)", "lang": "en" }, "uri": "assets/p9991634_p_v5_aa.jpg", "category": "Poster Art", "text": "yes", "primary": "true" } }, "stationId": "74320", "station": { "stationId": "74320", "callSign": "EPIX3SD", "preferredImage": { "width": "360", "height": "270", "uri": "h3/NowShowing/74320/s74320_h3_aa.png", "category": "Logo", "primary": "true" }, "channel": "598" } }, { "startTime": "2015-02-11T03:50Z", "endTime": "2015-02-11T05:50Z", "duration": 120, "qualifiers": ["CC"], "channels": ["598"], "program": { "tmsId": "MV004884770000", "rootId": "9991634", "subType": "Feature Film", "title": "Nebraska", "releaseYear": 2013, "releaseDate": "2013-05-22", "titleLang": "en", "descriptionLang": "en", "entityType": "Movie", "genres": ["Drama"], "longDescription": "Cantankerous old buzzard Woody Grant (Bruce Dern) can barely walk down the street of his home in Billings, Mont., without stopping for a drink. So when Woody receives receives a sweepstakes notice in the mail and insists on making a 750-mile trip to Lincoln, Neb., to collect his prize, it falls to baffled son David (Will Forte) to accompany him. During a stop in their Nebraska hometown, word gets out about Woody's fortune, first making him a hero, then later, the target of predatory people.", "shortDescription": "A man sets out on a road trip with his aging father to claim a cash prize that may not really exist.", "topCast": ["Bruce Dern", "Will Forte", "June Squibb"], "directors": ["Alexander Payne"], "qualityRating": { "ratingsBody": "TMS", "value": "3.5" }, "preferredImage": { "width": "240", "height": "360", "caption": { "content": "Nebraska (2013)", "lang": "en" }, "uri": "assets/p9991634_p_v5_aa.jpg", "category": "Poster Art", "text": "yes", "primary": "true" } }, "stationId": "74320", "station": { "stationId": "74320", "callSign": "EPIX3SD", "preferredImage": { "width": "360", "height": "270", "uri": "h3/NowShowing/74320/s74320_h3_aa.png", "category": "Logo", "primary": "true" }, "channel": "598" } }]
