Get History

Returns the user’s watch history.

GET /history

Récupérer l'historique de visionnage

cURL

curl --request GET \
  --url https://dejavu.plus/api/v1/history \
  --header 'x-api-key: <api-key>'

200

{
  "data": [
    {
      "id": 123,
      "type": "movie",
      "title": "<string>",
      "posterPath": "<string>",
      "watchedAt": "2023-11-07T05:31:56Z",
      "count": 1,
      "episodeId": 123,
      "seasonNumber": 123,
      "episodeNumber": 123
    }
  ],
  "pagination": {
    "page": 123,
    "pageSize": 123,
    "totalItems": 123,
    "totalPages": 123
  },
  "success": true
}

Usage

Returns the authenticated user’s watch history with pagination and filtering options.

Authentication is required via x-api-key or Authorization: Bearer.

Example

curl -H "x-api-key: $DEJAVU_API_KEY" "https://dejavu.plus/api/v1/history?page=1&pageSize=20"

Parameters and response

Query parameters, filters, and response schemas are defined by the OpenAPI specification displayed on this page.

Errors

See Responses for the operation-specific error codes and formats.

Notes

Episodes can be identified directly or with their series, season, and episode context.

Authorizations

ApiKeyHeaderBearerAuth

x-api-key · string · header · required

Clé API dejaVu. pk_* = lecture seule ; sk_* = lecture et écriture.

Query Parameters

type · enum<string> · default: all

Available options: all, movie, tv, episode

page · integer

Numéro de page (à partir de 1).

Required range: x >= 1

sort · enum<string>

Tri (ex: watchedAt:desc, watchedAt:asc)

Available options: watchedAt:asc, watchedAt:desc

minimal · boolean · default: false

Retourner uniquement type et id

pageSize · integer

Nombre d'éléments par page (1 à 100).

Required range: x >= 1

Response

200

application/json

Historique de visionnage

data · object[] · required

Show child attributes

pagination · object · required

Show child attributes

success · boolean · default: true · required