2.1 Deprecation Notice!
Please be aware that the 2.1 version of our API has been deprecated. It has been replaced by v3. You can read the new API documentation here.

Movie.getVersion

The Movie.getVersion method is used to retrieve the last modified time along with the current version number of the called object(s). This is useful if you've already called the object sometime in the past and simply want to do a quick check for updates. This method supports calling anywhere between 1 and 50 items at a time.

Example URL

To search for a single ID:

http://api.themoviedb.org/2.1/Movie.getVersion/en/xml/APIKEY/585

To search for multiple IDs:

http://api.themoviedb.org/2.1/Movie.getVersion/en/xml/APIKEY/585,155,11,550

Options

Language: IETF Language Tag, e.g. en-US

Type: Type can be xml, yaml or json.

API Key: The API key we supplied you with for your account.

ID: The ID of the TMDb movie you are looking for. This field supports an integer value (TMDb movie id) an IMDB ID or a combination of both separated by a comma (,) if you are searching for multiple movies.

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<OpenSearchDescription xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">
  <opensearch:Query searchTerms="585,155,11,550"/>
  <opensearch:totalResults>4</opensearch:totalResults>
  <movies>
    <movie>
      <name>Monsters, Inc.</name>
      <id>585</id>
      <imdb_id>tt0198781</imdb_id>
      <version>309</version>
      <last_modified_at>2010-07-19 10:19:56</last_modified_at>
    </movie>
    <movie>
      <name>The Dark Knight</name>
      <id>155</id>
      <imdb_id>tt0468569</imdb_id>
      <version>41</version>
      <last_modified_at>2010-07-19 11:23:35</last_modified_at>
    </movie>
    <movie>
      <name>Star Wars: Episode IV - A New Hope</name>
      <id>11</id>
      <imdb_id>tt0076759</imdb_id>
      <version>17</version>
      <last_modified_at>2010-07-19 11:28:54</last_modified_at>
    </movie>
    <movie>
      <name>Fight Club</name>
      <id>550</id>
      <imdb_id>tt0137523</imdb_id>
      <version>28</version>
      <last_modified_at>2010-07-19 10:21:00</last_modified_at>
    </movie>
  </movies>
</OpenSearchDescription>