Skip to main content
GET
Get continue-watching shows

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

status
enum<string>
default:all

Filter by watch progress or provider series lifecycle. returning and legacy airing match Returning Series, including shows between seasons; legacy ended matches every other provider status, not just ended series.

Available options:
all,
watching,
completed,
returning,
airing,
ended

Response

Continue Watching items

showTmdbId
integer
required
Required range: x >= 1
sourceId
integer
required
Required range: x >= 1
mediaSource
string
required
title
string
required
year
integer
required
posterUrl
string
required
backdropUrl
string
required
communityRating
number
required
genres
string[]
required
status
string
required

Provider series lifecycle status, not the current episode release state. Returning Series can describe a show whose latest season has finished airing.

releasePhase
enum<string>
required

Best-effort schedule state for display, independent of watch progress and provider status. airing requires a released episode and a dated future episode in the same season; returning requires an announced future season. status and its query filters retain their provider-lifecycle semantics.

Available options:
airing,
returning,
upcoming,
season_complete,
schedule_pending,
ended,
canceled,
unknown
totalEpisodesWatched
integer
required
Required range: x >= 0
totalEpisodesAvailable
integer
required
Required range: x >= 0
totalPlays
integer
required
Required range: x >= 0
overallPercent
number
required
Required range: 0 <= x <= 100
currentSeasonNumber
integer
required

The season progress is focused on: nextSeason when an episode is playable, otherwise lastWatchedSeason.

Required range: x >= 0
currentSeasonEpisodesWatched
integer
required
Required range: x >= 0
currentSeasonEpisodesTotal
integer
required

Aired episodes in currentSeasonNumber.

Required range: x >= 0
currentSeasonPercent
number
required
Required range: 0 <= x <= 100
currentSeasonMinutesRemaining
integer
required

Sum of the listed runtimes of the season's unwatched aired episodes; an episode without a listed runtime counts as episodeRuntimeMinutes.

Required range: x >= 0
minutesWatched
integer
required
Required range: x >= 0
minutesRemaining
integer
required
Required range: x >= 0
episodeRuntimeMinutes
integer
required
Required range: x >= 0
episodeRuntimeSource
enum<string>
required

Where episodeRuntimeMinutes came from: history averages runtimes saved in the user's watch history; episode is the listed runtime of the next episode (or of the earliest gap when none is ahead); show is the provider's series runtime; unknown means no runtime is known and episodeRuntimeMinutes is 0.

Available options:
history,
episode,
show,
unknown
lastWatchedAt
string<date-time>
required
lastWatchedSeason
integer
required
Required range: x >= 0
lastWatchedEpisode
integer
required
Required range: x >= 0
lastSourceSeason
integer
required
Required range: x >= 0
lastSourceEpisode
integer
required
Required range: x >= 0
nextSeason
integer | null
required

Season of the first currently available unwatched episode after the last-watched episode; null when none is playable.

nextEpisode
integer | null
required

Episode of the first currently available unwatched episode after the last-watched episode; null when none is playable.

earlierUnwatchedSeason
integer | null
required

Season of the gap to fill first before the last-watched episode: the earliest unwatched aired episode in a season the user has started, or, when started seasons have no gaps, the earliest unwatched aired episode overall.

earlierUnwatchedEpisode
integer | null
required

Episode of the gap to fill first; see earlierUnwatchedSeason.

earlierUnwatchedCount
integer
required

Number of aired unwatched episodes before the last-watched episode, including seasons the user has not started.

Required range: x >= 0
currentSeasonName
string
currentSeasonEpisodesUnaired
integer

Announced episodes in currentSeasonNumber that have not aired yet; 0 when the whole season is out.

Required range: x >= 0
episodeBackdropUrl
string

Still image for the card: the next episode's, else the announced episode's, else the last-watched episode's.

lastWatchedEpisodeTitle
string
nextSourceSeason
integer | null
nextEpisodeTitle
string
nextSourceId
integer | null
nextSourceEpisode
integer | null
earlierUnwatchedSourceSeason
integer | null

Provider season of earlierUnwatchedSeason/earlierUnwatchedEpisode, for building episode links; differs only for anime mapped between episode orders, like nextSourceSeason.

earlierUnwatchedSourceEpisode
integer | null

Provider episode of the gap; see earlierUnwatchedSourceSeason.

earlierUnwatchedEpisodeTitle
string
nextEpisodeToAir
object

Announced future episode. airDate is omitted when the episode has been announced but not scheduled.