info:
  name: Get Reading Stats
  type: http
  seq: 4
http:
  method: GET
  url: '{{base_url}}/api/analytics/reading-stats'
  auth: inherit
  body:
    type: none
runtime:
  scripts:
  - type: tests
    code: "test(\"status must be 200\", function() {\n    expect(res.status).to.eql(200);"

docs: |-
  Get overall reading statistics for the authenticated user.
  
    **Endpoint**: GET /api/analytics/reading-stats
    **Auth**: Required (Bearer token)
  
    ## Query Parameters
  
    | Parameter | Type | Required | Description |
    |-----------|------|-----------|-------------|
    | start_date | string | No | Start date (ISO 8601 format) |
    | end_date | string | No | End date (ISO 8601 format) |
  
    ## Response Fields
  
    | Field | Type | Description |
    |-------|------|-------------|
    | total_books_read | int | Total books completed |
    | total_pages_read | int | Total pages read |
    | total_reading_time_minutes | int | Total reading time in minutes |
    | completion_rate | float | Average book completion rate (0-1) |
    | daily_reading_minutes | array | Daily reading time breakdown |
    | daily_reading_minutes[].date | string | Date (ISO 8601) |
    | daily_reading_minutes[].minutes | int | Minutes read on that date |
  
    ## Example Request
  
    ```
    GET /api/analytics/reading-stats
    ```
  
    ## Example Response
  
    ```json
    {
      "total_books_read": 12,
      "total_pages_read": 3450,
      "total_reading_time_minutes": 5400,
      "completion_rate": 0.78,
      "daily_reading_minutes": [
        {
          "date": "2026-01-15",
          "minutes": 45