Skip to main content

ReadProgressListResponse

Response containing a list of reading progress records

progress object[]required

List of progress records

  • Array [
  • 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
  • ]
  • totalintegerrequired

    Total count

    Possible values: >= 0

    Example: 25
    ReadProgressListResponse
    {
    "progress": [
    {
    "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"
    }
    ],
    "total": 25
    }