> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rewind.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Currently reading

> Returns articles currently being read (progress > 0 and < 0.75).



## OpenAPI

````yaml get /v1/reading/currently-reading
openapi: 3.1.0
info:
  title: Rewind API
  version: 1.0.0
  description: >-
    Personal data aggregation API. Syncs and serves data from Last.fm, Apple
    Music, Strava, Plex, Letterboxd, Discogs, Trakt, Instapaper, Google
    Calendar, and Gmail.


    ## Domains


    | Domain | Source | Description |

    |--------|--------|-------------|

    | **Listening** | Last.fm, Apple Music | Scrobbles, top
    artists/albums/tracks, streaks, stats |

    | **Running** | Strava | Activities, splits, gear, personal records, year
    summaries |

    | **Watching** | Plex, Letterboxd | Movies, TV shows, watch history,
    ratings, reviews |

    | **Collecting** | Discogs, Trakt | Vinyl/CD collection, physical media,
    wantlist |

    | **Reading** | Instapaper | Articles, highlights, reading progress, word
    count |

    | **Attending** | Google Calendar, Gmail | Live events, tickets, sports
    games, concerts, venues |


    ## Authentication


    All endpoints require a Bearer token. There are two key types:


    - **Read keys** (`rw_live_...`) — access all GET endpoints

    - **Admin keys** (`rw_admin_...`) — access all endpoints including sync
    triggers and data management


    Pass your key in the Authorization header: `Authorization: Bearer
    rw_live_...`


    ## Pagination


    List endpoints return paginated responses:


    ```json

    {
      "data": [...],
      "pagination": { "page": 1, "limit": 20, "total": 150, "total_pages": 8 }
    }

    ```


    The activity feed uses cursor-based pagination instead.


    ## Quick Start


    ```bash

    # Check the API is up

    curl https://api.rewind.rest/v1/health


    # Fetch recent scrobbles (requires read key)

    curl -H "Authorization: Bearer rw_live_..." \
      https://api.rewind.rest/v1/listening/recent

    # Fetch running stats

    curl -H "Authorization: Bearer rw_live_..." \
      https://api.rewind.rest/v1/running/stats
    ```


    ## Errors


    All errors follow the same envelope:


    ```json

    { "error": "Not found", "status": 404 }

    ```


    Common status codes: 400 (bad request), 401 (unauthorized), 404 (not found),
    500 (server error).
  contact:
    url: https://github.com/pdugan20/rewind
servers:
  - url: https://api.rewind.rest
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Listening
    description: Last.fm scrobbles, top charts, streaks, and stats.
  - name: Running
    description: Strava activities, splits, gear, records, and year summaries.
  - name: Watching
    description: >-
      Movies, TV shows, watch history, ratings, and reviews from Plex and
      Letterboxd.
  - name: Collecting
    description: Vinyl/CD collection from Discogs and physical media from Trakt.
  - name: Reading
    description: Articles, highlights, and reading stats from Instapaper.
  - name: Attending
    description: >-
      Live events you bought tickets for — sports games, concerts, theater.
      Sourced from Google Calendar and ticket-vendor email.
  - name: Feed
    description: Cross-domain activity feed with cursor-based pagination.
  - name: Search
    description: Full-text search across all domains.
  - name: Images
    description: Image proxy with on-the-fly transforms via Cloudflare Images.
  - name: System
    description: Health checks and sync status.
  - name: Admin
    description: >-
      API key management, sync triggers, and data administration. Requires admin
      key.
  - name: Webhooks
    description: Inbound webhook receivers for Strava and Plex. No auth required.
paths:
  /v1/reading/currently-reading:
    get:
      tags:
        - Reading
      summary: Currently reading
      description: Returns articles currently being read (progress > 0 and < 0.75).
      operationId: getReadingCurrentlyReading
      responses:
        '200':
          description: Currently reading articles
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: number
                        title:
                          type: string
                        author:
                          type:
                            - string
                            - 'null'
                        url:
                          type:
                            - string
                            - 'null'
                        instapaper_url:
                          type:
                            - string
                            - 'null'
                        instapaper_app_url:
                          type:
                            - string
                            - 'null'
                        domain:
                          type:
                            - string
                            - 'null'
                        site_name:
                          type:
                            - string
                            - 'null'
                        description:
                          type:
                            - string
                            - 'null'
                        word_count:
                          type:
                            - number
                            - 'null'
                        estimated_read_min:
                          type:
                            - number
                            - 'null'
                        status:
                          type: string
                        progress:
                          type: number
                        starred:
                          type: boolean
                        rating:
                          type:
                            - number
                            - 'null'
                        tags:
                          type: array
                          items:
                            type: string
                        source:
                          type: string
                        image: {}
                        saved_at:
                          type: string
                        started_at:
                          type:
                            - string
                            - 'null'
                        finished_at:
                          type:
                            - string
                            - 'null'
                      required:
                        - id
                        - title
                        - author
                        - url
                        - instapaper_url
                        - instapaper_app_url
                        - domain
                        - site_name
                        - description
                        - word_count
                        - estimated_read_min
                        - status
                        - progress
                        - starred
                        - rating
                        - tags
                        - source
                        - saved_at
                        - started_at
                        - finished_at
                required:
                  - data
              example:
                data:
                  - id: 87
                    title: Why the Internet Isn't Working
                    author: Maxwell Zeff
                    url: https://www.wired.com/story/why-the-internet-isnt-working
                    instapaper_url: https://www.instapaper.com/read/2345678
                    instapaper_app_url: instapaper://read/2345678
                    domain: wired.com
                    site_name: Wired
                    description: The web was supposed to connect us. What went wrong?
                    word_count: 4500
                    estimated_read_min: 18
                    status: reading
                    progress: 0.45
                    starred: false
                    rating: null
                    tags:
                      - technology
                      - internet
                    source: instapaper
                    image: null
                    saved_at: '2026-03-20T10:00:00.000Z'
                    started_at: '2026-03-21T07:30:00.000Z'
                    finished_at: null
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          example: Not found
        status:
          type: integer
          example: 404
      required:
        - error
        - status
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key. Read keys (rw_live_...) access GET endpoints. Admin keys
        (rw_admin_...) access all endpoints.

````