---
title: "Returns the scrobbling history for the user"
method: POST
path: "/api/Scrobbling/scrobble-events"
tags: ["Scrobbling"]
---

# Returns the scrobbling history for the user

`POST /api/Scrobbling/scrobble-events`

## Request

- Base URL: `http://localhost:5000`
- URL: `http://localhost:5000/api/Scrobbling/scrobble-events`
- Auth: API key in header `x-api-key`

User must have a valid license

## Query parameters

- `PageNumber` integer
- `PageSize` integer

## Request body

- ScrobbleEventFilter
  - `field` 0 | 1 | 2 | 3 | 4 | 5 | 6: Members: - `0` — None - `1` — Created - `2` — LastModified - `3` — Type - `4` — Series - `5` — IsProcessed - `6` — ScrobbleEventFilter
  - `isDescending` boolean
  - `query` string, nullable
  - `includeReviews` boolean

## Response `200`

OK

- ScrobbleEventDto[]
  - `id` integer
  - `seriesName` string, nullable
  - `seriesId` integer
  - `libraryId` integer
  - `isProcessed` boolean
  - `volumeNumber` number, float, nullable
  - `chapterNumber` integer, nullable
  - `lastModifiedUtc` string, date-time
  - `createdUtc` string, date-time
  - `rating` number, float, nullable
  - `readStatus` 0 | 1 | 2 | 3 | 4 | 5: Members: - `0` — Ignore - `1` — Want to Read (WantToRead) - `2` — Read - `3` — Un read (UnRead) - `4` — Dropped - `5` — On hold (OnHold)
  - `scrobbleEventType` 0 | 1 | 2 | 3 | 4 | 5: Members: - `0` — Chapter Read (ChapterRead) - `1` — Add to Want to Read (AddWantToRead) - `2` — Remove from Want to Read (RemoveWantToRead) - `3` — Score Updated (ScoreUpdated) - `4` — Review Added/Updated (Review) - `5` — Read status Updated (ReadStatusUpdate)
  - `scrobbleProvider` 0 | 1 | 2 | 4 | 5 | 6: Members: - `0` — Kavita - `1` — AniList - `2` — Mal - `4` — Cbr - `5` — Hardcover - `6` — MangaBaka
  - `isErrored` boolean
  - `errorDetails` string, nullable

## Changes

- **2026-06-05** `095d20153db4`: 3 warning, 6 info
  - added the new `5.00` enum value to the `items/scrobbleEventType` response property for the response status `200` (media type: text/plain)
  - added the new `5.00` enum value to the `items/scrobbleEventType` response property for the response status `200` (media type: application/json)
  - added the new `5.00` enum value to the `items/scrobbleEventType` response property for the response status `200` (media type: text/json)
  - added the optional property `items/readStatus` to the response with the `200` status (media type: text/plain)
  - …5 more
- **2025-06-20** `8a6957f3cc8c`: 3 info
  - added the optional property `items/id` to the response with the `200` status (media type: text/plain)
  - added the optional property `items/id` to the response with the `200` status (media type: application/json)
  - added the optional property `items/id` to the response with the `200` status (media type: text/json)

[Operation history](https://skmtc.dev/kareadita/apis/kavita/changes/api/Scrobbling/scrobble-events/post.md)

---

[API](https://skmtc.dev/kareadita/apis/kavita.md) - [All operations](https://skmtc.dev/kareadita/apis/kavita/llms.txt) - [OpenAPI document](https://skmtc.dev/kareadita/apis/kavita/revisions/d266465eeb67?raw)