2.1 Deprecation Notice!

Please be aware that the 2.1 version of our API has been deprecated. 2.1 will be shut down on September 15, 2013. It has been replaced by v3. You can read the new API documentation here.

Person.getVersion

The Person.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/Person.getVersion/en/xml/APIKEY/287

To search for multiple IDs:

http://api.themoviedb.org/2.1/Person.getVersion/en/xml/APIKEY/287,5064,819

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 person you are looking for. This field supports an integer value (TMDb person id) and should be separated by a comma (,) if you are searching for multiple people.

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<OpenSearchDescription xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">
  <opensearch:Query searchTerms="287,5064,819"/>
  <opensearch:totalResults>3</opensearch:totalResults>
  <movies>
    <movie>
      <name>Brad Pitt</name>
      <id>287</id>
      <version>11</version>
      <last_modified_at>2010-07-19 10:26:30</last_modified_at>
    </movie>
    <movie>
      <name>Meryl Streep</name>
      <id>5064</id>
      <version>4</version>
      <last_modified_at>2010-07-19 10:22:42</last_modified_at>
    </movie>
    <movie>
      <name>Edward Norton</name>
      <id>819</id>
      <version>3</version>
      <last_modified_at>2010-07-19 10:26:29</last_modified_at>
    </movie>
  </movies>
</OpenSearchDescription>