Get items on a personal list

get

https://api.trakt.tv/users/{id}/lists/{list_id}/items/{type}/{sort_by}/{sort_how}

🔓 OAuth Optional 📄 Pagination ✨ Extended Info 🎚 Filters

Returns items on a personal list. Use type, sort_by, and sort_how to control the returned item set and order.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

The slug that identifies the user, or "me" for the authenticated user.

list_id

string

required

type

string

required

List item type filter.

sort_by

string

required

Sort by a specific property.

sort_how

string

required

Sort direction.

Query Params

extended

string

Extended information to include in the response.

watchnow

string | null

enum

Use "favorites" for streaming on a favorite service of the user.
Use "any" for streaming on any service in the user's country.
Use "any_all" for streaming on any service in all countries.
Use "free" for streaming for free in the user's country.
Use "free_all" for streaming for free in all countries.
Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.
Use "subscriptions_all" streaming on any subscription service in all countries

Allowed:

genres

string | null

subgenres

string | null

years

string | null

ratings

string | null

start_date

string | null

end_date

string | null

runtimes

string | null

countries

string | null

certifications

string | null

ignore_watched

boolean | null

Ignore watched items.

ignore_collected

boolean | null

Ignore collected items.

ignore_watchlisted

boolean | null

Ignore watchlisted items.

page

integer | null

The page number to retrieve

limit

string | null

The number of items per page, can be a number or the value all

Response

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200