Authentication
Account
Certifications
Configuration
Credits
Find
Keywords
Movies
- POSTAdd rating
- DELDelete rating
- GETFetch account states
- GETFetch alternative titles
- GETFetch external IDs
- GETFetch latest movie
- GETFetch movie changes
- GETFetch movie credits
- GETFetch movie details
- GETFetch movie images
- GETFetch movie keywords
- GETFetch movie List
- GETFetch movie recommendations
- GETFetch movie translation
- GETFetch release dates
- GETFetch similar movies
- GETFetch user reviews
- GETFetch videos
- GETFetch watch providers
People
People-Lists
Reviews
Search
Tv-episode-groups
Tv-episodes
Tv-seasons
Tv-Series
- POSTAdd rating
- DELDelete rating
- GETFetch account states
- GETFetch aggregate credits
- GETFetch alternative titles
- GETFetch content ratings
- GETFetch episode groups
- GETFetch external IDs
- GETFetch latest TV shows
- GETFetch reviews
- GETFetch series images
- GETFetch similar shows
- GETFetch theatrically screened
- GETFetch TV changes
- GETFetch TV credits
- GETFetch TV details
- GETFetch TV keywords
- GETFetch tv show translations
- GETFetch tv show videos
- GETFetch watch providers
- GETList TV series
Authentication
Account
Certifications
Configuration
Movies
- GETFetch movie details
- GETFetch account states
- GETFetch alternative titles
- GETFetch movie changes
- GETFetch movie credits
- GETFetch external IDs
- GETFetch movie images
- GETFetch movie keywords
- GETFetch latest movie
- GETFetch movie List
- GETFetch movie recommendations
- GETFetch release dates
- GETFetch user reviews
- GETFetch similar movies
- GETFetch movie translation
- GETFetch videos
- GETFetch watch providers
- POSTAdd rating
- DELDelete rating
Credits
Find
Search
Keywords
People Lists
People
Reviews
TV Series
- GETFetch TV details
- GETFetch account states
- GETFetch aggregate credits
- GETFetch alternative titles
- GETFetch TV changes
- GETFetch content ratings
- GETFetch TV credits
- GETFetch episode groups
- GETFetch external IDs
- GETFetch series images
- GETFetch TV keywords
- GETFetch latest TV shows
- GETList TV series
- GETFetch TV recommendations
- GETFetch reviews
- GETFetch theatrically screened
- GETFetch similar shows
- GETFetch tv show translations
- GETFetch tv show videos
- GETFetch watch providers
- POSTAdd rating
- DELDelete rating
TV Seasons
TV Episodes
TV Episode groups
TV Seasons
Fetch account states
This endpoint allows you to get the rating, watchlist, and favourite status.
GET
/
tv
/
{series_id}
/
season
/
{season_number}
/
account_states
Copy
curl --request GET \
--url https://api.themoviedb.org/3/tv/%7B{series_id}%7D/season/%7B{season_number}%7D/account_states \
--header 'Authorization: Bearer <token>'
Copy
{
"id": 3624,
"results": [
{
"episode_number": 1,
"id": 63056,
"rated": false
},
{
"episode_number": 2,
"id": 63057,
"rated": false
},
{
"episode_number": 3,
"id": 63058,
"rated": false
},
{
"episode_number": 4,
"id": 63059,
"rated": false
},
{
"episode_number": 5,
"id": 63060,
"rated": false
},
{
"episode_number": 6,
"id": 63061,
"rated": false
},
{
"episode_number": 7,
"id": 63062,
"rated": false
},
{
"episode_number": 8,
"id": 63063,
"rated": false
},
{
"episode_number": 9,
"id": 63064,
"rated": false
},
{
"episode_number": 10,
"id": 63065,
"rated": false
}
]
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
Example:
"7427e7f0d08c503a855b022dc5a2e124577150b8"
Defaults to en-US
Example:
"string"
Response
200 - application/json
Fetch account states
The response is of type object
.
Copy
curl --request GET \
--url https://api.themoviedb.org/3/tv/%7B{series_id}%7D/season/%7B{season_number}%7D/account_states \
--header 'Authorization: Bearer <token>'
Copy
{
"id": 3624,
"results": [
{
"episode_number": 1,
"id": 63056,
"rated": false
},
{
"episode_number": 2,
"id": 63057,
"rated": false
},
{
"episode_number": 3,
"id": 63058,
"rated": false
},
{
"episode_number": 4,
"id": 63059,
"rated": false
},
{
"episode_number": 5,
"id": 63060,
"rated": false
},
{
"episode_number": 6,
"id": 63061,
"rated": false
},
{
"episode_number": 7,
"id": 63062,
"rated": false
},
{
"episode_number": 8,
"id": 63063,
"rated": false
},
{
"episode_number": 9,
"id": 63064,
"rated": false
},
{
"episode_number": 10,
"id": 63065,
"rated": false
}
]
}
Assistant
Responses are generated using AI and may contain mistakes.