Summary

Returns all custom lists for a user. Protected users won't return any data unless you are friends. To view your own private lists, you will need to authenticate as yourself.

URL

http://api.trakt.tv/user/lists.format/apikey/username

Supported formats

json

Supported request methods

GET

Requires authentication

optional (details)

If this user has a protected profile, valid auth will allow data to be returned for yourself and any friends.

Required Parameters

• apikey

  Sign in to view your API key.

• username

  You can get a username by browsing the website and looking at the URL when on a profile page.

Example Request

http://api.trakt.tv/user/lists.json/apikey/justin

[
   {
      "name":"Star Wars",
      "slug":"star-wars",
      "url":"http://trakt.tv/user/justin/lists/star-wars",
      "description":"The complete Star Wars saga!",
      "privacy":"public",
      "show_numbers":true, //rank each item
      "allow_shouts":true //allow shouts on this list
   },
   {
      "name":"Vampires FTW",
      "slug":"vampires-ftw",
      "url":"http://trakt.tv/user/justin/lists/vampires-ftw",
      "description":"These suck, but in a good way!",
      "privacy":"friends",
      "show_numbers":false, //don't rank each item
      "allow_shouts":true //don't allow shouts on this list
   },
   {
      "name":"Legendary",
      "slug":"legendary",
      "url":"http://trakt.tv/user/justin/lists/legendary",
      "description":"Truly legend (wait for it) dary episodes of How I Met Your Mother.",
      "privacy":"private",
      "show_numbers":false,
      "allow_shouts":true //don't allow shouts on this list
   }
]