Summary

Returns list details and all items it contains. 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/list.format/apikey/username/slug

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. If you send valid auth, each item will contain watched (boolean), in_collection (boolean), in_watchlist (boolean), rating (love or hate, false if not rated), and rating_advanced (1-10, 0 if not rated).

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.

• slug

  Valid list slug for this user. You can get all slugs from the user/lists method.

Example Request

http://api.trakt.tv/user/list.json/apikey/justin/star-wars

{
   "name":"Example",
   "slug":"example",
   "url":"http://trakt.tv/user/justin/list/example",
   "description":"One of each",
   "privacy":"public",
   "show_numbers":false, //don't rank each item,
   "allow_shouts":true, //allow shouts on this list
   "items":[
      {
         "type":"movie",
         "movie":{
            "title":"Batman Begins",
            "year":2005,
            "released":1118991600,
            "url":"http://trakt.tv/movie/batman-begins-2005",
            "trailer":"http://www.youtube.com/watch?v=m7dapUWHykw",
            "runtime":141,
            "tagline":"Evil fears the knight.",
            "overview":"Bruce Wayne has watched his home, Gotham City, turn into a crime infested abyss throughout his entire life, so he decides to become the hero Gotham needs- Batman!",
            "certification":"PG-13",
            "imdb_id":"tt0372784",
            "tmdb_id":"272",
            "images":{
               "poster":"http://trakt.us/images/poster-dark.1.jpg",
               "fanart":"http://trakt.us/images/fanart-dark.1.jpg"
            },
            "ratings":{
               "percentage":96,
               "votes":588,
               "loved":562,
               "hated":26
            },
            "genres":["Action","Comedy"]
         }
      },
      {
         "type":"show",
         "show":{
            "title":"Mad Men",
            "year":2007,
            "url":"http://trakt.tv/show/mad-men",
            "first_aired":1184828400,
            "country":"United States",
            "overview":"Set in 1960 New York, MAD MEN reveals the lives of the ruthlessly competitive men and women of Madison Avenue’s “Golden Age”, where key players make the art of the sell while their private lives get sold. And no one plays the game better than Don Draper (Golden Globe®-winner Jon Hamm), the biggest ad man – and ladies man in the business.",
            "runtime":60,
            "network":"AMC",
            "air_day":"Sunday",
            "air_time":"10:00pm",
            "certification":"TV-14",
            "imdb_id":"tt0804503",
            "tvdb_id":"80337",
            "tvrage_id":"16356",
            "images":{
               "poster":"http://trakt.us/images/posters/20.jpg",
               "fanart":"http://trakt.us/images/fanart/20.jpg",
               "banner":"http://trakt.us/images/banners/20.jpg"
            },
            "ratings":{
               "percentage":92,
               "votes":409,
               "loved":377,
               "hated":32
            },
            "genres":["Action","Comedy"]
         }
      },
      {
         "type":"season",
         "show":{
            "title":"Mad Men",
            "year":2007,
            "url":"http://trakt.tv/show/mad-men",
            "first_aired":1184828400,
            "country":"United States",
            "overview":"Set in 1960 New York, MAD MEN reveals the lives of the ruthlessly competitive men and women of Madison Avenue’s “Golden Age”, where key players make the art of the sell while their private lives get sold. And no one plays the game better than Don Draper (Golden Globe®-winner Jon Hamm), the biggest ad man – and ladies man in the business.",
            "runtime":60,
            "network":"AMC",
            "air_day":"Sunday",
            "air_time":"10:00pm",
            "certification":"TV-14",
            "imdb_id":"tt0804503",
            "tvdb_id":"80337",
            "tvrage_id":"16356",
            "images":{
               "poster":"http://trakt.us/images/posters/20.jpg",
               "fanart":"http://trakt.us/images/fanart/20.jpg",
               "banner":"http://trakt.us/images/banners/20.jpg"
               "season":"http://trakt.us/images/season/20-1.jpg"
            },
            "ratings":{
               "percentage":92,
               "votes":409,
               "loved":377,
               "hated":32
            },
            "genres":["Action","Comedy"]
         },
         "season":1
      },
      {
         "type":"episode",
         "show":{
            "title":"Mad Men",
            "year":2007,
            "url":"http://trakt.tv/show/mad-men",
            "first_aired":1184828400,
            "country":"United States",
            "overview":"Set in 1960 New York, MAD MEN reveals the lives of the ruthlessly competitive men and women of Madison Avenue’s “Golden Age”, where key players make the art of the sell while their private lives get sold. And no one plays the game better than Don Draper (Golden Globe®-winner Jon Hamm), the biggest ad man – and ladies man in the business.",
            "runtime":60,
            "network":"AMC",
            "air_day":"Sunday",
            "air_time":"10:00pm",
            "certification":"TV-14",
            "imdb_id":"tt0804503",
            "tvdb_id":"80337",
            "tvrage_id":"16356",
            "images":{
               "poster":"http://trakt.us/images/posters/20.jpg",
               "fanart":"http://trakt.us/images/fanart/20.jpg",
               "banner":"http://trakt.us/images/banners/20.jpg"
            },
            "ratings":{
               "percentage":92,
               "votes":409,
               "loved":377,
               "hated":32
            },
            "genres":["Action","Comedy"]
         },
         "season":1,
         "episode_num":2,
         "episode":{
            "season":1,
            "episode":2,
            "title":"Ladies Room",
            "overview":"Betty consults with a specialist about her health issues; Don is pressured to help with Nixon's presidential campaign; Peggy fends off the advances of a copywriter.",
            "first_aired":1185433200,
            "url":"http://trakt.tv/show/mad-men/season/1/episode/2",
            "images":{
               "screen":"http://trakt.us/images/fanart/20-940.jpg"
            },
            "ratings":{
               "percentage":90,
               "votes":10,
               "loved":9,
               "hated":1
            }
         }
      }
   ]
}