Reading Sessions

User-related API environment

Pre-live user-related API docs

These pages describe the Pre-live user-related API stack.

Use pre-live OAuth credentials, pre-live API base URLs, and pre-live app URLs when following this documentation. Keep your OAuth flow, API requests, callback URLs, and manual testing within the pre-live environment.

• Use prelive.quran.com for auth-related testing.
• Use prelive.quranreflect.org for Quran Reflect paths where applicable.
• Do not mix production sessions or production user data with pre-live testing.

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.