Activity Days

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.

Track daily Quran reading activity and estimated reading time.

📄️ Add/update activity day

Create or update the user's daily activity record for one date and one activity type. Activity Days power streaks, goals, and calendar-style progress.

📄️ Get activity days

Get the user's activity days for calendar/history views. Activity Days contain daily progress totals such as read ranges, pages, seconds, and goal progress for each date and activity type. Use `from`/`to` to filter by date range and `type` to filter by activity type.

📄️ Estimate reading time

Estimate how many seconds it would take to read one or more verse ranges. This is useful when a client has ranges but needs a reasonable seconds value for manual/backfilled Quran activity. The estimate is based on average reading speed observed on Quran.com.