---
method: POST
path: /api/sync/koreader/stats
auth: device-token
area: koreader
---
<!-- source: internal/handlers/koreader.go:1854 KOReaderHandler.PushKOReaderStats -->

# Push KOReader Stats

Pushes cumulative reading seconds for a book; only the delta above the
stored watermark becomes a reading_history session.

## Example request

```json example-request
{
  "total_seconds": 3600
}
```

## Example response

```json example-response
{
  "total_seconds": 3600,
  "watermark": 0,
  "delta_seconds": 3600,
  "session_recorded": true,
  "session_seconds": 3600
}
```

The request body also embeds the koreader book reference used to resolve
the book — fields (all optional, resolved via the same priority chain as
progress sync): `uuid`, `sha256`, `title`, `authors` (string array).