Skip to main content

ReadProgressResponse

Response containing reading progress for a book

book_idstring<uuid>required

Book ID

Example: 550e8400-e29b-41d4-a716-446655440002
completedbooleanrequired

Whether the book is completed

Example: false
completed_atstring,null<date-time>nullable

When the book was completed (if completed)

Example: 2024-01-20T20:00:00Z
current_pageinteger<int32>required

Current page (1-indexed)

Example: 42
idstring<uuid>required

Progress record ID

Example: 550e8400-e29b-41d4-a716-446655440000
progress_percentagenumber,null<double>nullable

Progress as a percentage (0.0-1.0) For EPUBs, this is the stored percentage from reflowable content For other formats, this is calculated from current_page / total_pages

Example: 0.45
started_atstring<date-time>required

When reading started

Example: 2024-01-10T14:30:00Z
updated_atstring<date-time>required

When progress was last updated

Example: 2024-01-15T18:45:00Z
user_idstring<uuid>required

User ID

Example: 550e8400-e29b-41d4-a716-446655440001
ReadProgressResponse
{
"book_id": "550e8400-e29b-41d4-a716-446655440002",
"completed": false,
"completed_at": "2024-01-20T20:00:00Z",
"current_page": 42,
"id": "550e8400-e29b-41d4-a716-446655440000",
"progress_percentage": 0.45,
"started_at": "2024-01-10T14:30:00Z",
"updated_at": "2024-01-15T18:45:00Z",
"user_id": "550e8400-e29b-41d4-a716-446655440001"
}