Activity Days

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.

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.