Reading Sessions

User-related API environment

Production user-related API docs

These pages describe the Production user-related API stack.

Use production OAuth credentials, production API base URLs, and production app URLs when following this documentation.

Need to test before going live? Switch to the Pre-live docs using the environment switcher above.

Record and retrieve user reading progress sessions.

📄️ Add or update user reading session

Track the user's most recent reading location (Surah/Ayah) for 'Continue reading' / 'Recently read' UX. This endpoint stores location only; it does not credit reading time, streaks, goals, or activity-calendar progress.

📄️ Get user reading sessions

Get the user's reading sessions, ordered most recent first. Reading sessions are location history for 'Continue reading' and 'Recently read' UX. They do not represent daily progress totals; for streaks, goals, and calendar-style progress, use Activity Days.