Dashboard
Get upcoming episodes and movies
Fetch upcoming episodes and movie releases for titles in the user's library, sorted by date. Supports cursor-based pagination.
Authorization
session better-auth.session_token<token>
Better Auth session cookie
In: cookie
Query Parameters
days?integer
How many days into the future to look
Default
90Range
1 <= value <= 90limit?integer
Maximum items per page
Default
20Range
1 <= value <= 50cursor?string
Pagination cursor
mediaType?string
Filter to only movies or only TV episodes
Value in
"movie" | "tv"statusFilter?array<>
Filter by user tracking status
Response Body
application/json
curl -X GET "http://localhost:3000/api/v1/dashboard/upcoming"{
"items": [
{
"episodeId": "string",
"titleId": "string",
"titleName": "string",
"titleType": "movie",
"posterPath": "string",
"posterThumbHash": "string",
"backdropPath": "string",
"backdropThumbHash": "string",
"seasonNumber": 0,
"episodeNumber": 0,
"episodeName": "string",
"episodeCount": 0,
"date": "string",
"userStatus": "in_watchlist",
"isNewSeason": true,
"streamingProvider": {
"platformId": "string",
"providerName": "string",
"logoPath": "string"
}
}
],
"nextCursor": "string"
}