Movies

Future releases

/movies/futureReleases

Returns a list of movies being released in US or Canadian theaters up to 6 months in the future. Release information includes date, type, and distributors. Response data will be sorted by release date.

Request Parameters

Parameter	Mandatory?	Description
releaseDate	Yes	Date to start search. Format yyyy-mm-dd.
Can be up to 7 days prior to current date.
numDays	No	Number of days to search, starting with releaseDate. Maximum search is 180 days. If not specified, will default to 60 days.
country	No	USA or CAN. Movies being released in selected country will be returned. Default is USA.
titleLang	No	Filter results based on the specified title language. Use IETF language tags (2-letter abbreviations, with optional 2-letter region extensions). If not specified, defaults to 'en'.
descriptionLang	No	Filter results based on the specified description language. Use IETF language tags (2-letter abbreviations, with optional 2-letter region extensions). If not specified, defaults to 'en'.
imageSize	No	Requested size of image returned in preferredImage URI. Valid values are: Sm, Md, Lg, Ms. If not specified, defaults to Md. 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.
api_key	Yes	24-character key obtained during application registration

Response Body

Response	Description
tmsId	Resource identifier for movie
title	Movie title, as set for release
titleLang	2-letter language abbreviation code (e.g., 'en'=English, 'sp'=Spanish)
shortDescription	Movie description, maximum 100 characters.
descLang	2-letter language abbreviation code (e.g., 'en'=English, 'sp'=Spanish)
ratings	Ratings metadata, if available
body	Ratings body; currently returning only MPAA ratings for movies
code	Ratings code; e.g., G, PG, PG-13
genres	Comma-separated list of movie genres (e.g., Romance, Horror, Comedy)
topCast	Comma-separated list of top 3 cast member names, if available.
preferredImage	Movie image, if available
releaseYear	Original year of release, regardless of release country
releases	Release metadata, includes the following:
date	Date of release for specific country and distributor; formatted yyyy-mm-dd
type	Release type (e.g., Original, Limited, Wide, Subsequent)
distributors	Release distributor names
country	Release country; 3-letter country code
runTime	Movie duration, specified in ISO-8601 format; PTxxHyyM = xx hours, yy minutes
entityType	Program type (Movie)

Sample Request

http://data.tmsapi.com/v1.1/movies/futureReleases?releaseDate=2015-02-09&numDays=5&api_key=1234567890

Sample Response


Code
 
    [{
        "tmsId": "MV005455480000",
        "rootId": "10498277",
        "subType": "Feature Film",
        "title": "Hits",
        "releaseYear": 2014,
        "releaseDate": "2014-01-21",
        "titleLang": "en",
        "descriptionLang": "en",
        "entityType": "Movie",
        "genres": ["Comedy"],
        "longDescription": "A talentless teen (Meredith Hagner) will do anything to get on TV's \"The Voice.\" Meanwhile, her father (Matt Walsh), a municipal worker, creates an uproar when a video of his rants at City Hall goes viral.",
        "shortDescription": "A teen will do anything to get on \"The Voice,\" while her father's rant at City Hall goes viral.",
        "topCast": ["Meredith Hagner", "Matt Walsh", "James Adomian"],
        "directors": ["David Cross"],
        "advisories": ["Adult Situations"],
        "runTime": "PT01H40M",
        "preferredImage": {
            "uri": "tvbanners/generic/generic_tvbanners_v5.png"
        },
        "releases": [{
            "date": "2015-02-12",
            "country": "USA",
            "type": "Limited",
            "distributors": [{
                "name": "Honora Productions"
            }]
        }]
    },]

Last modified on November 13, 2025

Movies Movie airings on TV

/movies/futureReleases

Request Parameters

Parameter

Mandatory?

Description

releaseDate

Yes

Date to start search. Format yyyy-mm-dd.

Can be up to 7 days prior to current date.

numDays

Number of days to search, starting with releaseDate. Maximum search is 180 days. If not specified, will default to 60 days.

country

USA or CAN. Movies being released in selected country will be returned. Default is USA.

titleLang

Filter results based on the specified title language. Use IETF language tags (2-letter abbreviations, with optional 2-letter region extensions). If not specified, defaults to 'en'.

descriptionLang

Filter results based on the specified description language. Use IETF language tags (2-letter abbreviations, with optional 2-letter region extensions). If not specified, defaults to 'en'.

imageSize

Requested size of image returned in preferredImage URI. Valid values are: Sm, Md, Lg, Ms. If not specified, defaults to Md. If requested image size is not available, generic image will be returned.

imageText

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.

api_key

Yes

24-character key obtained during application registration

Response Body

Response

Description

tmsId

Resource identifier for movie

title

Movie title, as set for release

titleLang

2-letter language abbreviation code (e.g., 'en'=English, 'sp'=Spanish)

shortDescription

Movie description, maximum 100 characters.

descLang

2-letter language abbreviation code (e.g., 'en'=English, 'sp'=Spanish)

ratings

Ratings metadata, if available

body

Ratings body; currently returning only MPAA ratings for movies

code

Ratings code; e.g., G, PG, PG-13

genres

Comma-separated list of movie genres (e.g., Romance, Horror, Comedy)

topCast

Comma-separated list of top 3 cast member names, if available.

preferredImage

Movie image, if available

releaseYear

Original year of release, regardless of release country

releases

Release metadata, includes the following:

date

Date of release for specific country and distributor; formatted yyyy-mm-dd

type

Release type (e.g., Original, Limited, Wide, Subsequent)

distributors

Release distributor names

country

Release country; 3-letter country code

runTime

Movie duration, specified in ISO-8601 format; PTxxHyyM = xx hours, yy minutes

entityType

Program type (Movie)

Sample Request

Sample Response

Code

    [{
        "tmsId": "MV005455480000",
        "rootId": "10498277",
        "subType": "Feature Film",
        "title": "Hits",
        "releaseYear": 2014,
        "releaseDate": "2014-01-21",
        "titleLang": "en",
        "descriptionLang": "en",
        "entityType": "Movie",
        "genres": ["Comedy"],
        "longDescription": "A talentless teen (Meredith Hagner) will do anything to get on TV's \"The Voice.\" Meanwhile, her father (Matt Walsh), a municipal worker, creates an uproar when a video of his rants at City Hall goes viral.",
        "shortDescription": "A teen will do anything to get on \"The Voice,\" while her father's rant at City Hall goes viral.",
        "topCast": ["Meredith Hagner", "Matt Walsh", "James Adomian"],
        "directors": ["David Cross"],
        "advisories": ["Adult Situations"],
        "runTime": "PT01H40M",
        "preferredImage": {
            "uri": "tvbanners/generic/generic_tvbanners_v5.png"
        },
        "releases": [{
            "date": "2015-02-12",
            "country": "USA",
            "type": "Limited",
            "distributors": [{
                "name": "Honora Productions"
            }]
        }]
    },]
 

Last modified on November 13, 2025