Skip to main content
GET
/
profile
/
history
/
{mediaId}
Get history items for a specific media
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.discovr.media/profile/history/{mediaId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "items": [
    {
      "id": "TV_1396",
      "mediaType": "tv",
      "title": "Breaking Bad",
      "poster_path": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
      "backdrop_path": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
      "updatedAt": "2023-01-15T00:00:00.000Z",
      "watched_count": 3,
      "createdAt": "2023-01-01T00:00:00.000Z",
      "progress": 45.5,
      "completed": false,
      "season": 1,
      "episode": 5,
      "imported": "trakt"
    }
  ],
  "hasMore": true,
  "nextPageToken": "<string>"
}

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.

Authorizations

​
Authorization
string
header
required

Bearer token authentication.

  • Identity-tier endpoints (/profiles, /auth/session-token, /auth/session) accept a long-lived refresh token (rt_<hex>).
  • Session-tier endpoints (/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}

Path Parameters

​
mediaId
string
required

The DiscovrID (TV_ or MV_) of the media item

Query Parameters

​
season
integer

Season number (required for TV shows only, must be provided when mediaId starts with TV_)

Required range: x >= 1
​
episode
integer

Episode number (optional for TV shows, only valid when mediaId starts with TV_). If not provided, returns all episodes in the season.

Required range: x >= 1
​
nextPageToken
string

Opaque token from previous page for pagination

​
limit
integer
default:10

Maximum number of items to return (1-50, default: 10)

Required range: 1 <= x <= 50

Response

List of history items retrieved successfully

​
items
object[]
required

Array of history items

​
hasMore
boolean
required

Whether there are more items available

Example:

true

​
nextPageToken
string

Opaque token to fetch the next page of results