Skip to main content

Reading statistics for the authenticated user

GET 
/api/v1/reading-stats

Totals, a time series, and breakdowns by device, series and format, all over one window so no two panels can disagree about which dates they cover.

Reading time is reported as two figures rather than one. Clients that measure their own sessions report time directly; the Komga-compatible, OPDS and KOReader surfaces cannot, so theirs is reconstructed from the gaps between their writes. That reconstruction undercounts and is blind to reading done from an already-downloaded book, so it is kept separable rather than blended into a total that would quietly overstate its own accuracy.

Always scoped to the caller. There is no way to read another user's history.

Request​

Responses​

Reading statistics for the window