Retrieves all items from the history list for a specific profile.
Items are returned in descending order by creation date (newest first).
Supports cursor-based pagination using the nextPageToken query parameter.
Pagination:
nextPageToken from the previous response to fetch the next pagehasMore is true, there are more items available on subsequent pages.Duplicates: Unlike other lists, the history list allows duplicate entries. Each watch event creates a new history entry.
TV Shows:
For TV shows, history entries include season information and optionally episode information. When a TV history item has no episode field, it represents a “Default for Episode” entry. Frontend clients should treat these entries as applying to all episodes in the season where episode.air_date < historyItem.updatedAt. This allows updating multiple episodes with a single history entry. The matching logic is a client-side concern and not exposed by the API.
Media Assets: All items include media assets (id, title, poster_path, backdrop_path) automatically.
Documentation Index
Fetch the complete documentation index at: https://docs.discovr.media/llms.txt
Use this file to discover all available pages before exploring further.
Bearer token authentication.
/profiles, /auth/session-token,
/auth/session) accept a long-lived refresh token
(rt_<hex>)./pages/*, /profile/*) accept a
short-lived session JWT.SDK clients use two typed API accessors (identityApi() with the
refresh token vs sessionApi() with the session JWT) — see the SDK
DiscovrAuth helper.
Format: Authorization: Bearer {token}
Opaque token from previous page for pagination
Maximum number of items to return (1-50, default: 10)
1 <= x <= 50