This method requires a developer API key with check in permissions.

Summary

Check into a movie on trakt. Think of this method as in between a seen and a scrobble. After checking in, the trakt will automatically display it as watching then switch over to watched status once the duration has elapsed.

URL

http://api.trakt.tv/movie/checkin/apikey

Supported formats

json

Supported request methods

POST

Requires authentication

true (details)

Required Parameters

• apikey

  Requires a developer API key. Details here.

• JSON POST

  • username

    trakt username.

  • password

    SHA1 hash of trakt password.

  • imdb_id

    IMDB ID for the movie.

    If you don't have the IMDB ID, you can send the TMDB ID. If you still don't have that, make sure the title and year match trakt exactly.

  • tmdb_id (optional)

    TMDB (themoviedb.org) ID for the movie.

  • title

    Movie title.

  • year

    Movie year.

  • duration (optional)

    Duration in minutes. If not sent, the movie runtime will be used.

  • venue_id (optional)

    Foursquare venue ID.

  • venue_name (optional)

    Custom venue name for display purposes.

  • share (optional)

    Control how the check in shared to the user's connected social networks. If you send true for a connected social network. If you send false or that social network is not connected it won't send anything.

    "share": {
    	"facebook": true,
    	"twitter": true,
    	"tumblr": false
    }

  • message (optional)

    The message to use for sharing. If not sent, it will use the localized watching string set on the connections page. The message will be truncated to 100 characters to make sure it fits in the tweet with the url and hashtag.

  • app_version

    Version number of the app, be as specific as you can including nightly build number, etc. Used to help debug.

  • app_date

    Build date of the media center. Used to help debug.

Example JSON POST

{
	"username": "username",
	"password": "sha1hash",
	"imdb_id": "tt0372784",
	"title": "Batman Begins",
	"year": 2005,
	"duration": 141,
	"app_version": "1.0",
	"app_date": "June 4 2011",
	"venue_id": 1234,
	"shared": {
		"facebook": true,
		"twitter": false
	},
	"message": "Batman Begins is the start to something amazing!"
}

Example Response

{
	"status": "success",
	"message": "checked in to Batman Begins (2005)",
	"timestamps": {
		"start": 1330670727,
		"end": 1330757267,
		"active_for": 8460
	},
	"movie": {
		"title": "Batman Begins",
		"year": 2005,
		"imdb_id": "tt0372784",
		"tmdb_id": 808
	},
	"facebook": false,
	"twitter": false,
	"tumblr": false,
	"foursquare": false
}

If there is already a recent checkin, it will error out. You can then ask the user if they want to cancel their previous checkin or wait the indicated time.

{
   "status":"failure",
   "error":"There is already a checkin in progress. Either cancel this checkin or wait 1 hour, 32 minutes before you can check in again.",
   "wait":5550
}