Movie versions

/movies/:rootId/versions

Returns detailed metadata about all versions of a specified movie.  Versions may differ by details such as format (e.g., 3D, IMAX), runtime, or language.

Response metadata will include cast, crew, and awards information.

Request Parameters

Parameter

Mandatory?

Description

rootId

Yes

Root ID, which can be obtained via airings, movies, or celebrity APIs

imageSize

No

Valid values are: Sm, Md, Lg, Ms. See Image Sizing for details.
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.

descriptionLang No Filter results based on the specified description language. Use IETF language tags (2-letter abbreviations, with optional 2-letter region extensions). When not provided, returns English versions, or if no English descriptions available, returns versions with descriptionLang of primary TMS ID.

api_key

Yes

24-character key obtained during application registration

Response Body

Response

Type

Description

Movie metadata

Program [ ]

Detailed information regarding all versions of specified movie.

Sample Request

Return movie metadata for all versions of movie; rootId is acquired from response data of other APIs (e.g., celebrity lookup shows movie data in mediography).

http://data.tmsapi.com/v1.1/movies/9991634/versions?api_key=1234567890

Sample Response 

TMS IDs are unique for each movie version. Ratings could vary by version; for example, Director’s Cut versions are often rated higher than original release version.

In sample below, note version differences in title field: Avatar, Avatar 3D, Avatar: An IMAX Experience. Also note runtime differences between versions.


[{
    "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.",
    "cast": [{
        "billingOrder": "01",
        "role": "Actor",
        "nameId": "9564",
        "personId": "9564",
        "name": "Bruce Dern",
        "characterName": "Woody Grant"
    }, {
        "billingOrder": "02",
        "role": "Actor",
        "nameId": "294843",
        "personId": "291018",
        "name": "Will Forte",
        "characterName": "David Grant"
    }, {
        "billingOrder": "03",
        "role": "Actor",
        "nameId": "273287",
        "personId": "269698",
        "name": "June Squibb",
        "characterName": "Kate Grant"
    }, {
        "billingOrder": "04",
        "role": "Actor",
        "nameId": "195614",
        "personId": "193829",
        "name": "Bob Odenkirk",
        "characterName": "Ross Grant"
    }, {
        "billingOrder": "05",
        "role": "Actor",
        "nameId": "891",
        "personId": "891",
        "name": "Stacy Keach",
        "characterName": "Ed Pegram"
    }, {
        "billingOrder": "06",
        "role": "Actor",
        "nameId": "85497",
        "personId": "85497",
        "name": "Mary Louise Wilson",
        "characterName": "Aunt Martha"
    }, {
        "billingOrder": "07",
        "role": "Actor",
        "nameId": "71730",
        "personId": "71730",
        "name": "Rance Howard",
        "characterName": "Ray"
    }, {
        "billingOrder": "08",
        "role": "Actor",
        "nameId": "749522",
        "personId": "718856",
        "name": "Tim Driscoll",
        "characterName": "Bart"
    }, {
        "billingOrder": "09",
        "role": "Actor",
        "nameId": "16614",
        "personId": "16614",
        "name": "Devin Ratray",
        "characterName": "Cole"
    }, {
        "billingOrder": "10",
        "role": "Actor",
        "nameId": "690215",
        "personId": "663625",
        "name": "Angela McEwan",
        "characterName": "Peg"
    }, {
        "billingOrder": "11",
        "role": "Actor",
        "nameId": "866433",
        "personId": "826145",
        "name": "Elizabeth Moore",
        "characterName": "Aunt Flo"
    }, {
        "billingOrder": "12",
        "role": "Actor",
        "nameId": "757454",
        "personId": "725926",
        "name": "Kevin Kunkel",
        "characterName": "Cousin Randy"
    }, {
        "billingOrder": "13",
        "role": "Actor",
        "nameId": "792914",
        "personId": "757604",
        "name": "Dennis McCoig",
        "characterName": "Uncle Verne"
    }, {
        "billingOrder": "14",
        "role": "Actor",
        "nameId": "792916",
        "personId": "757606",
        "name": "Ronald Vosta",
        "characterName": "Uncle Albert"
    }],
    "crew": [{
        "billingOrder": "01",
        "role": "Director",
        "nameId": "70201",
        "personId": "70201",
        "name": "Alexander Payne"
    }, {
        "billingOrder": "02",
        "role": "Screenwriter",
        "nameId": "866438",
        "personId": "826150",
        "name": "Bob Nelson"
    }, {
        "billingOrder": "03",
        "role": "Producer",
        "nameId": "749519",
        "personId": "718853",
        "name": "Albert Berga"
    }, {
        "billingOrder": "04",
        "role": "Producer",
        "nameId": "301026",
        "personId": "297110",
        "name": "Ron Yerxa"
    }, {
        "billingOrder": "05",
        "role": "Executive Producer",
        "nameId": "469444",
        "personId": "460569",
        "name": "George Parra"
    }, {
        "billingOrder": "06",
        "role": "Executive Producer",
        "nameId": "692321",
        "personId": "665568",
        "name": "Julie M. Thompson"
    }, {
        "billingOrder": "07",
        "role": "Executive Producer",
        "nameId": "298136",
        "personId": "294271",
        "name": "Doug Mankoff"
    }, {
        "billingOrder": "08",
        "role": "Executive Producer",
        "nameId": "529078",
        "personId": "513438",
        "name": "Neil Tabatznik"
    }, {
        "billingOrder": "09",
        "role": "Cinematographer",
        "nameId": "141115",
        "personId": "141115",
        "name": "Phedon Papamichael"
    }, {
        "billingOrder": "10",
        "role": "Film Editor",
        "nameId": "661249",
        "personId": "637668",
        "name": "Kevin Trent"
    }, {
        "billingOrder": "11",
        "role": "Original Music",
        "nameId": "471173",
        "personId": "462298",
        "name": "Mark Orton"
    }, {
        "billingOrder": "12",
        "role": "Production Design",
        "nameId": "501169",
        "personId": "481134",
        "name": "Dennis Washington"
    }, {
        "billingOrder": "13",
        "role": "Art Director",
        "nameId": "471081",
        "personId": "462206",
        "name": "Sandy Veneziano"
    }, {
        "billingOrder": "14",
        "role": "Set Decoration",
        "nameId": "866429",
        "personId": "457706",
        "name": "Fontaine Beauchamp"
    }, {
        "billingOrder": "15",
        "role": "Costume Designer",
        "nameId": "485298",
        "personId": "476423",
        "name": "Wendy Chuck"
    }, {
        "billingOrder": "16",
        "role": "Casting",
        "nameId": "389185",
        "personId": "380310",
        "name": "John Jackson"
    }],
    "directors": ["Alexander Payne"],
    "awards": [{
        "awardId": "1",
        "name": "Academy Award",
        "awardName": "Academy Award",
        "year": "2013",
        "category": "Best Writing",
        "awardCatId": "21"
    }, {
        "awardId": "2",
        "name": "Golden Globe",
        "awardName": "Golden Globe",
        "year": "2013",
        "category": "Best Screenplay - Motion Picture",
        "awardCatId": "43"
    }, {
        "awardId": "2",
        "name": "Golden Globe",
        "awardName": "Golden Globe",
        "year": "2013",
        "category": "Best Motion Picture - Comedy or Musical",
        "awardCatId": "32"
    }, {
        "awardId": "1",
        "name": "Academy Award",
        "awardName": "Academy Award",
        "year": "2013",
        "category": "Best Picture",
        "awardCatId": "15"
    }, {
        "awardId": "6",
        "name": "British Academy of Film & Television Arts",
        "awardName": "British Academy of Film & Television Arts",
        "year": "2013",
        "category": "Cinematography",
        "awardCatId": "163"
    }, {
        "awardId": "1",
        "name": "Academy Award",
        "awardName": "Academy Award",
        "year": "2013",
        "category": "Best Cinematography",
        "awardCatId": "5"
    }, {
        "awardId": "1",
        "name": "Academy Award",
        "awardName": "Academy Award",
        "year": "2013",
        "category": "Best Directing",
        "awardCatId": "7"
    }, {
        "awardId": "3",
        "recipient": "June Squibb",
        "name": "Screen Actors Guild Awards",
        "awardName": "Screen Actors Guild Awards",
        "personId": "269698",
        "year": "2013",
        "category": "Outstanding Performance by a Female Actor in a Supporting Role",
        "awardCatId": "48"
    }, {
        "awardId": "2",
        "name": "Golden Globe",
        "awardName": "Golden Globe",
        "year": "2013",
        "category": "Best Performance By an Actress in a Supporting Role in a Motion Picture",
        "awardCatId": "257"
    }, {
        "awardId": "1",
        "name": "Academy Award",
        "awardName": "Academy Award",
        "year": "2013",
        "category": "Best Supporting Actress",
        "awardCatId": "19"
    }, {
        "awardId": "1",
        "name": "Academy Award",
        "awardName": "Academy Award",
        "year": "2013",
        "category": "Best Actor",
        "awardCatId": "1"
    }, {
        "awardId": "2",
        "name": "Golden Globe",
        "awardName": "Golden Globe",
        "year": "2013",
        "category": "Best Performance By an Actor in a Motion Picture - Comedy or Musical",
        "awardCatId": "256"
    }, {
        "awardId": "6",
        "name": "British Academy of Film & Television Arts",
        "awardName": "British Academy of Film & Television Arts",
        "year": "2013",
        "category": "Leading Actor",
        "awardCatId": "182"
    }, {
        "awardId": "2",
        "name": "Golden Globe",
        "awardName": "Golden Globe",
        "year": "2013",
        "category": "Best Director - Motion Picture",
        "awardCatId": "27"
    }, {
        "awardId": "3",
        "recipient": "Bruce Dern",
        "name": "Screen Actors Guild Awards",
        "awardName": "Screen Actors Guild Awards",
        "personId": "9564",
        "year": "2013",
        "category": "Outstanding Performance by a Male Actor in a Leading Role",
        "awardCatId": "45"
    }, {
        "awardId": "6",
        "name": "British Academy of Film & Television Arts",
        "awardName": "British Academy of Film & Television Arts",
        "year": "2013",
        "category": "Original Screenplay",
        "awardCatId": "195"
    }],
    "keywords": {
        "Mood": ["Brooding", "Profound", "Somber"],
        "Time Period": ["2010s"],
        "Theme": ["Discovery", "Fall", "Pursuit"],
        "Character": ["Old man", "Alcoholic", "Son", "Predator", "Friend", "Lottery winner"],
        "Setting": ["Montana", "Nebraska", "Bar", "House", "Office building", "Car"],
        "Subject": ["Money", "Trust", "Celebrity", "Alcoholism", "Friendship"]
    },
    "officialUrl": "http://www.nebraskamovie.com/",
    "qualityRating": {
        "ratingsBody": "TMS",
        "value": "3.5"
    },
    "ratings": [{
        "body": "British Board of Film Classification",
        "code": "15"
    }, {
        "body": "Alberta's Film Classification Board",
        "code": "14A"
    }, {
        "body": "Motion Picture Association of America",
        "code": "R"
    }],
    "advisories": ["Adult Language", "Adult Situations"],
    "runTime": "PT01H54M",
    "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"
    }
}, {
    "tmsId": "MV005978850000",
    "rootId": "9991634",
    "subType": "Feature Film",
    "title": "Nebraska",
    "releaseYear": 2013,
    "releaseDate": "2013",
    "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.",
    "cast": [{
        "billingOrder": "01",
        "role": "Actor",
        "nameId": "9564",
        "personId": "9564",
        "name": "Bruce Dern",
        "characterName": "Woody Grant"
    }, {
        "billingOrder": "02",
        "role": "Actor",
        "nameId": "294843",
        "personId": "291018",
        "name": "Will Forte",
        "characterName": "David Grant"
    }, {
        "billingOrder": "03",
        "role": "Actor",
        "nameId": "273287",
        "personId": "269698",
        "name": "June Squibb",
        "characterName": "Kate Grant"
    }, {
        "billingOrder": "04",
        "role": "Actor",
        "nameId": "195614",
        "personId": "193829",
        "name": "Bob Odenkirk",
        "characterName": "Ross Grant"
    }, {
        "billingOrder": "05",
        "role": "Actor",
        "nameId": "891",
        "personId": "891",
        "name": "Stacy Keach",
        "characterName": "Ed Pegram"
    }, {
        "billingOrder": "06",
        "role": "Actor",
        "nameId": "85497",
        "personId": "85497",
        "name": "Mary Louise Wilson",
        "characterName": "Aunt Martha"
    }, {
        "billingOrder": "07",
        "role": "Actor",
        "nameId": "71730",
        "personId": "71730",
        "name": "Rance Howard",
        "characterName": "Ray"
    }, {
        "billingOrder": "08",
        "role": "Actor",
        "nameId": "749522",
        "personId": "718856",
        "name": "Tim Driscoll",
        "characterName": "Bart"
    }, {
        "billingOrder": "09",
        "role": "Actor",
        "nameId": "16614",
        "personId": "16614",
        "name": "Devin Ratray",
        "characterName": "Cole"
    }, {
        "billingOrder": "10",
        "role": "Actor",
        "nameId": "690215",
        "personId": "663625",
        "name": "Angela McEwan",
        "characterName": "Peg"
    }, {
        "billingOrder": "11",
        "role": "Actor",
        "nameId": "866433",
        "personId": "826145",
        "name": "Elizabeth Moore",
        "characterName": "Aunt Flo"
    }, {
        "billingOrder": "12",
        "role": "Actor",
        "nameId": "757454",
        "personId": "725926",
        "name": "Kevin Kunkel",
        "characterName": "Cousin Randy"
    }, {
        "billingOrder": "13",
        "role": "Actor",
        "nameId": "792914",
        "personId": "757604",
        "name": "Dennis McCoig",
        "characterName": "Uncle Verne"
    }, {
        "billingOrder": "14",
        "role": "Actor",
        "nameId": "792916",
        "personId": "757606",
        "name": "Ronald Vosta",
        "characterName": "Uncle Albert"
    }],
    "crew": [{
        "billingOrder": "01",
        "role": "Director",
        "nameId": "70201",
        "personId": "70201",
        "name": "Alexander Payne"
    }, {
        "billingOrder": "02",
        "role": "Screenwriter",
        "nameId": "866438",
        "personId": "826150",
        "name": "Bob Nelson"
    }, {
        "billingOrder": "03",
        "role": "Producer",
        "nameId": "749519",
        "personId": "718853",
        "name": "Albert Berga"
    }, {
        "billingOrder": "04",
        "role": "Producer",
        "nameId": "301026",
        "personId": "297110",
        "name": "Ron Yerxa"
    }, {
        "billingOrder": "05",
        "role": "Executive Producer",
        "nameId": "469444",
        "personId": "460569",
        "name": "George Parra"
    }, {
        "billingOrder": "06",
        "role": "Executive Producer",
        "nameId": "692321",
        "personId": "665568",
        "name": "Julie M. Thompson"
    }, {
        "billingOrder": "07",
        "role": "Executive Producer",
        "nameId": "298136",
        "personId": "294271",
        "name": "Doug Mankoff"
    }, {
        "billingOrder": "08",
        "role": "Executive Producer",
        "nameId": "529078",
        "personId": "513438",
        "name": "Neil Tabatznik"
    }, {
        "billingOrder": "09",
        "role": "Cinematographer",
        "nameId": "141115",
        "personId": "141115",
        "name": "Phedon Papamichael"
    }, {
        "billingOrder": "10",
        "role": "Film Editor",
        "nameId": "661249",
        "personId": "637668",
        "name": "Kevin Trent"
    }, {
        "billingOrder": "11",
        "role": "Original Music",
        "nameId": "471173",
        "personId": "462298",
        "name": "Mark Orton"
    }, {
        "billingOrder": "12",
        "role": "Production Design",
        "nameId": "501169",
        "personId": "481134",
        "name": "Dennis Washington"
    }, {
        "billingOrder": "13",
        "role": "Art Director",
        "nameId": "471081",
        "personId": "462206",
        "name": "Sandy Veneziano"
    }, {
        "billingOrder": "14",
        "role": "Set Decoration",
        "nameId": "866429",
        "personId": "457706",
        "name": "Fontaine Beauchamp"
    }, {
        "billingOrder": "15",
        "role": "Costume Designer",
        "nameId": "485298",
        "personId": "476423",
        "name": "Wendy Chuck"
    }, {
        "billingOrder": "16",
        "role": "Casting",
        "nameId": "389185",
        "personId": "380310",
        "name": "John Jackson"
    }],
    "directors": ["Alexander Payne"],
    "awards": [{
        "awardId": "2",
        "recipient": "Bruce Dern",
        "name": "Golden Globe",
        "awardName": "Golden Globe",
        "personId": "9564",
        "year": "2013",
        "category": "Best Performance By an Actor in a Motion Picture - Comedy or Musical",
        "awardCatId": "256"
    }, {
        "awardId": "3",
        "recipient": "June Squibb",
        "name": "Screen Actors Guild Awards",
        "awardName": "Screen Actors Guild Awards",
        "personId": "269698",
        "year": "2013",
        "category": "Outstanding Performance by a Female Actor in a Supporting Role",
        "awardCatId": "48"
    }, {
        "awardId": "2",
        "recipient": "June Squibb",
        "name": "Golden Globe",
        "awardName": "Golden Globe",
        "personId": "269698",
        "year": "2013",
        "category": "Best Performance By an Actress in a Supporting Role in a Motion Picture",
        "awardCatId": "257"
    }, {
        "awardId": "1",
        "recipient": "June Squibb",
        "name": "Academy Award",
        "awardName": "Academy Award",
        "personId": "269698",
        "year": "2013",
        "category": "Best Supporting Actress",
        "awardCatId": "19"
    }, {
        "awardId": "1",
        "recipient": "Bruce Dern",
        "name": "Academy Award",
        "awardName": "Academy Award",
        "personId": "9564",
        "year": "2013",
        "category": "Best Actor",
        "awardCatId": "1"
    }, {
        "awardId": "3",
        "recipient": "Bruce Dern",
        "name": "Screen Actors Guild Awards",
        "awardName": "Screen Actors Guild Awards",
        "personId": "9564",
        "year": "2013",
        "category": "Outstanding Performance by a Male Actor in a Leading Role",
        "awardCatId": "45"
    }, {
        "awardId": "1",
        "name": "Academy Award",
        "awardName": "Academy Award",
        "year": "2013",
        "category": "Best Picture",
        "awardCatId": "15"
    }, {
        "awardId": "1",
        "name": "Academy Award",
        "awardName": "Academy Award",
        "year": "2013",
        "category": "Best Writing",
        "awardCatId": "21"
    }, {
        "awardId": "2",
        "name": "Golden Globe",
        "awardName": "Golden Globe",
        "year": "2013",
        "category": "Best Motion Picture - Comedy or Musical",
        "awardCatId": "32"
    }, {
        "awardId": "6",
        "name": "British Academy of Film & Television Arts",
        "awardName": "British Academy of Film & Television Arts",
        "year": "2013",
        "category": "Cinematography",
        "awardCatId": "163"
    }, {
        "awardId": "2",
        "name": "Golden Globe",
        "awardName": "Golden Globe",
        "year": "2013",
        "category": "Best Director - Motion Picture",
        "awardCatId": "27"
    }, {
        "awardId": "1",
        "name": "Academy Award",
        "awardName": "Academy Award",
        "year": "2013",
        "category": "Best Cinematography",
        "awardCatId": "5"
    }, {
        "awardId": "6",
        "name": "British Academy of Film & Television Arts",
        "awardName": "British Academy of Film & Television Arts",
        "year": "2013",
        "category": "Original Screenplay",
        "awardCatId": "195"
    }, {
        "awardId": "1",
        "name": "Academy Award",
        "awardName": "Academy Award",
        "year": "2013",
        "category": "Best Directing",
        "awardCatId": "7"
    }, {
        "awardId": "2",
        "name": "Golden Globe",
        "awardName": "Golden Globe",
        "year": "2013",
        "category": "Best Screenplay - Motion Picture",
        "awardCatId": "43"
    }, {
        "awardId": "6",
        "recipient": "Bruce Dern",
        "name": "British Academy of Film & Television Arts",
        "awardName": "British Academy of Film & Television Arts",
        "personId": "9564",
        "year": "2013",
        "category": "Leading Actor",
        "awardCatId": "182"
    }],
    "keywords": {
        "Mood": ["Brooding", "Profound", "Somber"],
        "Time Period": ["2010s"],
        "Theme": ["Discovery", "Fall", "Pursuit"],
        "Character": ["Old man", "Alcoholic", "Son", "Predator", "Friend", "Lottery winner"],
        "Setting": ["Montana", "Nebraska", "Bar", "House", "Office building", "Car"],
        "Subject": ["Money", "Trust", "Celebrity", "Alcoholism", "Friendship"]
    },
    "officialUrl": "http://www.nebraskamovie.com/",
    "qualityRating": {
        "ratingsBody": "TMS",
        "value": "3.5"
    },
    "ratings": [{
        "body": "British Board of Film Classification",
        "code": "15"
    }, {
        "body": "Motion Picture Association of America",
        "code": "R"
    }],
    "advisories": ["Adult Language", "Adult Situations"],
    "runTime": "PT01H54M",
    "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"
    }
}]