Summary

Returns all settings for the authenticated user. Use these settings to customize your app based on the user's settings. For example, if they use advanced ratings show a 10 heart scale. If they prefer simple ratings, show the binary scale. The social connections are also useful to customize the checkin prompt.

URL

http://api.trakt.tv/account/settings/apikey

Supported formats

json

Supported request methods

POST

Requires authentication

true (details)

Required Parameters

• apikey

  Sign in to view your API key.

• JSON POST

  • username

    Username to register.

  • password

    SHA1 hash of password.

Example JSON POST

{
	"username": "justin",
	"password": "sha1hash"
}

Example Response (success)

{
   "status":"success",
   "message":"All settings for justin",
   "profile":{
      "username":"justin",
      "full_name":"Justin",
      "gender":"male",
      "age":30,
      "location":"San Diego, CA",
      "about":"Co-founder of trakt. Please use the feedback tab on the right side to leave us suggestions or bugs you come across. Hope you're enjoying the site!",
      "joined":1285436965,
      "last_login":1334901801,
      "avatar":"http://trakt.us/images/avatars/1.4.jpg",
      "url":"http://trakt.tv/user/justin",
      "vip":true
   },
   "account":{
      "timezone":"UM8", //go.trakt.tv/HX7SfQ
      "use_24hr":false,
      "protected":false
   },
   "viewing":{
      "ratings":{
         "mode":"advanced" //simple,advanced
      },
      "shouts":{
         "show_badges":false,
         "show_spoilers":false
      }
   },
   "connections":{
      "facebook":{
         "connected":true,
         "timeline_enabled":true,
         "share_scrobbles_start":true,
         "share_scrobbles_end":true,
         "share_tv":true,
         "share_movies":true,
         "share_ratings":true,
         "share_checkins":true
      },
      "twitter":{
         "connected":true,
         "share_scrobbles_start":false,
         "share_scrobbles_end":false,
         "share_tv":true,
         "share_movies":true,
         "share_ratings":false,
         "share_checkins":false
      },
      "tumblr":{
         "connected":true,
         "share_scrobbles_start":false,
         "share_scrobbles_end":false,
         "share_tv":true,
         "share_movies":true,
         "share_ratings":false,
         "share_checkins":false
      }
   },
   "sharing_text":{
      "watching":"I'm watching [item]",
      "watched":"I just watched [item]"
   }
}

Example Response (failure)

{
	"status": "failure",
	"error": "failed authentication"
}