# Quran Foundation API > API documentation for Quran.com content, search, user, and authentication APIs. ## OpenAPI Specifications - [Content APIs v4](https://api-docs.quran.foundation/openAPI/content/v4.json): Verses, chapters, translations, tafsirs, audio - [User APIs v1](https://api-docs.quran.foundation/openAPI/user-related-apis/v1.json): Bookmarks, collections, notes, profiles, rooms, posts - [OAuth2 APIs v1](https://api-docs.quran.foundation/openAPI/oauth2-apis/v1.json): Authentication and authorization - [Search APIs v1](https://api-docs.quran.foundation/openAPI/search/v1.json): Quran text search ## Getting Started - [Field Reference](https://api-docs.quran.foundation/docs/api/field-reference) - [🚀 Quick Start Guide](https://api-docs.quran.foundation/docs/quickstart) - [📢 API Updates](https://api-docs.quran.foundation/docs/updates) ## Content APIs v4 - [Lookup verse by timestamp](https://api-docs.quran.foundation/docs/content_apis_versioned/audio-reciter-lookup) - [Get timestamp range](https://api-docs.quran.foundation/docs/content_apis_versioned/audio-reciter-timestamp) - [Chapter Infos](https://api-docs.quran.foundation/docs/content_apis_versioned/chapter-info) - [Get chapter's audio file of a reciter](https://api-docs.quran.foundation/docs/content_apis_versioned/chapter-reciter-audio-file) - [List of all chapter audio files of a reciter](https://api-docs.quran.foundation/docs/content_apis_versioned/chapter-reciter-audio-files) - [List of Chapter Reciters](https://api-docs.quran.foundation/docs/content_apis_versioned/chapter-reciters) - [Content APIs](https://api-docs.quran.foundation/docs/content_apis_versioned/content-apis) - [Get Chapter Info](https://api-docs.quran.foundation/docs/content_apis_versioned/get-chapter-info) - [Get Chapter](https://api-docs.quran.foundation/docs/content_apis_versioned/get-chapter) - [Get Foot Note](https://api-docs.quran.foundation/docs/content_apis_versioned/get-foot-note) - [Get Hizb](https://api-docs.quran.foundation/docs/content_apis_versioned/get-hizb) - [Get Juz](https://api-docs.quran.foundation/docs/content_apis_versioned/get-juz) - [Get Manzil](https://api-docs.quran.foundation/docs/content_apis_versioned/get-manzil) - [Get Rubʿ al-Ḥizb](https://api-docs.quran.foundation/docs/content_apis_versioned/get-rub-el-hizb) - [Get Ruku](https://api-docs.quran.foundation/docs/content_apis_versioned/get-ruku) - [Languages](https://api-docs.quran.foundation/docs/content_apis_versioned/languages) - [Get Ayah recitations for specific Ayah](https://api-docs.quran.foundation/docs/content_apis_versioned/list-ayah-recitation) - [Get tafsirs for specific Ayah](https://api-docs.quran.foundation/docs/content_apis_versioned/list-ayah-tafsirs) - [Get translations for specific Ayah](https://api-docs.quran.foundation/docs/content_apis_versioned/list-ayah-translations) - [List Chapters](https://api-docs.quran.foundation/docs/content_apis_versioned/list-chapters) - [Get Ayah recitations for specific Hizb](https://api-docs.quran.foundation/docs/content_apis_versioned/list-hizb-recitation) - [Get tafsirs for specific Hizb](https://api-docs.quran.foundation/docs/content_apis_versioned/list-hizb-tafsirs) - [Get translations for specific Hizb](https://api-docs.quran.foundation/docs/content_apis_versioned/list-hizb-translations) - [List Hizbs](https://api-docs.quran.foundation/docs/content_apis_versioned/list-hizbs) - [Get Ayah recitations for specific Juz](https://api-docs.quran.foundation/docs/content_apis_versioned/list-juz-recitation) - [Get tafsirs for specific Juz](https://api-docs.quran.foundation/docs/content_apis_versioned/list-juz-tafsirs) - [Get translations for specific Juz](https://api-docs.quran.foundation/docs/content_apis_versioned/list-juz-translations) - [List Juzs](https://api-docs.quran.foundation/docs/content_apis_versioned/list-juzs) - [Get Ayah recitations for specific Manzil](https://api-docs.quran.foundation/docs/content_apis_versioned/list-manzil-recitation) - [Get tafsirs for specific Manzil](https://api-docs.quran.foundation/docs/content_apis_versioned/list-manzil-tafsirs) - [Get translations for specific Manzil](https://api-docs.quran.foundation/docs/content_apis_versioned/list-manzil-translations) - [List Manzils](https://api-docs.quran.foundation/docs/content_apis_versioned/list-manzils) - [Get Ayah recitations for specific Madani Mushaf page](https://api-docs.quran.foundation/docs/content_apis_versioned/list-page-recitation) - [Get tafsirs for specific Madani Mushaf page](https://api-docs.quran.foundation/docs/content_apis_versioned/list-page-tafsirs) - [Get translations for specific Madani Mushaf page](https://api-docs.quran.foundation/docs/content_apis_versioned/list-page-translations) - [Get Ayah recitations for specific Rub el Hizb](https://api-docs.quran.foundation/docs/content_apis_versioned/list-rub-el-hizb-recitation) - [Get tafsirs for specific Rub el Hizb](https://api-docs.quran.foundation/docs/content_apis_versioned/list-rub-el-hizb-tafsirs) - [Get translations for specific Rub el Hizb](https://api-docs.quran.foundation/docs/content_apis_versioned/list-rub-el-hizb-translations) - [List Rubʿ al-Ḥizb](https://api-docs.quran.foundation/docs/content_apis_versioned/list-rub-el-hizbs) - [Get Ayah recitations for specific Ruku](https://api-docs.quran.foundation/docs/content_apis_versioned/list-ruku-recitation) - [Get tafsirs for specific Ruku](https://api-docs.quran.foundation/docs/content_apis_versioned/list-ruku-tafsirs) - [Get translations for specific Ruku](https://api-docs.quran.foundation/docs/content_apis_versioned/list-ruku-translations) - [List Rukus](https://api-docs.quran.foundation/docs/content_apis_versioned/list-rukus) - [Get Ayah recitations for specific Surah](https://api-docs.quran.foundation/docs/content_apis_versioned/list-surah-recitation) - [Get tafsirs for specific Surah](https://api-docs.quran.foundation/docs/content_apis_versioned/list-surah-tafsirs) - [Get translations for specific Surah](https://api-docs.quran.foundation/docs/content_apis_versioned/list-surah-translations) - [Get Quran verses in a specific script](https://api-docs.quran.foundation/docs/content_apis_versioned/quran-verses-by-script) - [Get V1 Glyph codes of ayah](https://api-docs.quran.foundation/docs/content_apis_versioned/quran-verses-code-v-1) - [Get V2 Glyph codes of ayah](https://api-docs.quran.foundation/docs/content_apis_versioned/quran-verses-code-v-2) - [Get Imlaei Simple text of ayah](https://api-docs.quran.foundation/docs/content_apis_versioned/quran-verses-imlaei) - [Get Indopak Nastaleeq Script of ayah](https://api-docs.quran.foundation/docs/content_apis_versioned/quran-verses-indopak-nastaleeq) - [Get Indopak Script of ayah](https://api-docs.quran.foundation/docs/content_apis_versioned/quran-verses-indopak) - [Get Uthmani simple script of ayah](https://api-docs.quran.foundation/docs/content_apis_versioned/quran-verses-uthmani-simple) - [Get Uthmani Tajweed Script of ayah](https://api-docs.quran.foundation/docs/content_apis_versioned/quran-verses-uthmani-tajweed) - [Get Uthmani Script of ayah](https://api-docs.quran.foundation/docs/content_apis_versioned/quran-verses-uthmani) - [Get random ayah](https://api-docs.quran.foundation/docs/content_apis_versioned/random-verse) - [Get list of Audio files of single recitation](https://api-docs.quran.foundation/docs/content_apis_versioned/recitation-audio-files) - [Recitation Info](https://api-docs.quran.foundation/docs/content_apis_versioned/recitation-info) - [Recitation Styles](https://api-docs.quran.foundation/docs/content_apis_versioned/recitation-styles) - [Recitations](https://api-docs.quran.foundation/docs/content_apis_versioned/recitations) - [Tafsir Info](https://api-docs.quran.foundation/docs/content_apis_versioned/tafsir-info) - [Get a single tafsir](https://api-docs.quran.foundation/docs/content_apis_versioned/tafsir) - [Tafsirs](https://api-docs.quran.foundation/docs/content_apis_versioned/tafsirs) - [Translation Info](https://api-docs.quran.foundation/docs/content_apis_versioned/translation-info) - [Get a single translation](https://api-docs.quran.foundation/docs/content_apis_versioned/translation) - [Translations](https://api-docs.quran.foundation/docs/content_apis_versioned/translations) - [Verse Media](https://api-docs.quran.foundation/docs/content_apis_versioned/verse-media) - [By Chapter](https://api-docs.quran.foundation/docs/content_apis_versioned/verses-by-chapter-number) - [By Hizb number](https://api-docs.quran.foundation/docs/content_apis_versioned/verses-by-hizb-number) - [By Juz](https://api-docs.quran.foundation/docs/content_apis_versioned/verses-by-juz-number) - [By Manzil](https://api-docs.quran.foundation/docs/content_apis_versioned/verses-by-manzil-number) - [By Page](https://api-docs.quran.foundation/docs/content_apis_versioned/verses-by-page-number) - [By Range](https://api-docs.quran.foundation/docs/content_apis_versioned/verses-by-range) - [By Rub el Hizb number](https://api-docs.quran.foundation/docs/content_apis_versioned/verses-by-rub-el-hizb-number) - [By Ruku](https://api-docs.quran.foundation/docs/content_apis_versioned/verses-by-ruku-number) - [By Specific Verse By Key](https://api-docs.quran.foundation/docs/content_apis_versioned/verses-by-verse-key) ## User-Related APIs v1 - [Reading Sessions vs Activity Days](https://api-docs.quran.foundation/docs/user-related-apis/reading-sessions-vs-activity-days) - [Add collection Bookmark](https://api-docs.quran.foundation/docs/user_related_apis_versioned/add-collection-bookmark) - [Add collection](https://api-docs.quran.foundation/docs/user_related_apis_versioned/add-collection) - [Add note](https://api-docs.quran.foundation/docs/user_related_apis_versioned/add-note) - [Add or update preference](https://api-docs.quran.foundation/docs/user_related_apis_versioned/add-or-update-preference) - [Add or update user reading session](https://api-docs.quran.foundation/docs/user_related_apis_versioned/add-or-update-user-reading-session) - [Add/update activity day](https://api-docs.quran.foundation/docs/user_related_apis_versioned/add-update-activity-day) - [Add user bookmark](https://api-docs.quran.foundation/docs/user_related_apis_versioned/add-user-bookmark) - [Bulk add or update preferences](https://api-docs.quran.foundation/docs/user_related_apis_versioned/bulk-add-or-update-preferences) - [Create a new comment](https://api-docs.quran.foundation/docs/user_related_apis_versioned/comments-controller-create) - [Delete a comment](https://api-docs.quran.foundation/docs/user_related_apis_versioned/comments-controller-delete-comment) - [Get replies to a comment](https://api-docs.quran.foundation/docs/user_related_apis_versioned/comments-controller-get) - [Toggle like/unlike a comment](https://api-docs.quran.foundation/docs/user_related_apis_versioned/comments-controller-toggle-like) - [Create a goal](https://api-docs.quran.foundation/docs/user_related_apis_versioned/create-a-goal) - [Delete a goal](https://api-docs.quran.foundation/docs/user_related_apis_versioned/delete-a-goal) - [Delete Bookmark](https://api-docs.quran.foundation/docs/user_related_apis_versioned/delete-bookmark) - [Delete collection bookmark by id](https://api-docs.quran.foundation/docs/user_related_apis_versioned/delete-collection-bookmark-by-id) - [Delete collection](https://api-docs.quran.foundation/docs/user_related_apis_versioned/delete-collection) - [Delete note by ID](https://api-docs.quran.foundation/docs/user_related_apis_versioned/delete-note-by-id) - [Estimate reading time](https://api-docs.quran.foundation/docs/user_related_apis_versioned/estimate-reading-time) - [Generate timeline estimation](https://api-docs.quran.foundation/docs/user_related_apis_versioned/generate-timeline-estimation) - [Get activity days](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-activity-days) - [Get all collection items](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-all-collection-items) - [Get all collections](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-all-collections) - [Get all notes](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-all-notes) - [Get bookmark collections](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-bookmark-collections) - [Get bookmark](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-bookmark) - [Get bookmarks within a range of Ayahs](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-bookmarks-within-a-range-of-ayahs) - [Get collection items by id](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-collection-items-by-id) - [Get current streak days](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-current-streak-days) - [Get note by ID](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-note-by-id) - [Get notes by attached entity](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-notes-by-attached-entity) - [Get notes by verse range](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-notes-by-verse-range) - [Get notes by verse](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-notes-by-verse) - [Get notes count within verse range](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-notes-count-within-verse-range) - [Get streaks](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-streaks) - [Get today's goal plan](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-todays-goal-plan) - [Get user bookmarks](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-user-bookmarks) - [Get user preferences](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-user-preferences) - [Get user reading sessions](https://api-docs.quran.foundation/docs/user_related_apis_versioned/get-user-reading-sessions) - [Create post](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-create) - [Delete post](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-delete) - [Edit post](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-edit) - [Export posts as PDF](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-export-multiple-posts) - [Get posts feed](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-feed) - [Get post by ID](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-find-one) - [Get all post comments](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-get-all-comment) - [Get post comments](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-get-comments) - [Get current user posts](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-get-loggedin-user-posts) - [Get posts by verse](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-get-my-posts-by-verse) - [Get posts count within range](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-get-my-posts-count-within-range) - [Get related posts](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-get-related-posts) - [Get user posts](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-get-user-post) - [Report post abuse](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-report-abuse) - [Toggle post like](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-toggle-like) - [Toggle post save](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-toggle-save) - [Track post view](https://api-docs.quran.foundation/docs/user_related_apis_versioned/posts-controller-view-tracking) - [Publish note](https://api-docs.quran.foundation/docs/user_related_apis_versioned/publish-note) - [Accept room invite by private token](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-accept-by-private-token) - [Accept room invite](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-accept-invite) - [Update room admin access](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-admins-access) - [Create a new group](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-create-new-group) - [Create a new page](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-create-new-page) - [Follow a page](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-follow-page) - [Get room members](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-get-room-members) - [Get room posts](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-get-room-posts) - [Get room profile by ID](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-get-room-profile-by-id) - [Get room profile by URL or subdomain](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-get-room-profile) - [Get joined or managed rooms](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-get-rooms) - [Invite user to room](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-invite-user-to-room) - [Join a group](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-join-room) - [Leave a group](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-leave-group) - [Reject room invite](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-reject-invite) - [Remove member from room](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-remove-member) - [Search rooms](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-search-rooms) - [Unfollow a page](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-unfollow-page) - [Update a group](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-update-group) - [Update a page](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-update-page) - [Update post privacy in room](https://api-docs.quran.foundation/docs/user_related_apis_versioned/rooms-controller-update-post-privacy) - [OAuth2 Scopes](https://api-docs.quran.foundation/docs/user_related_apis_versioned/scopes) - [Search and retrieve tags](https://api-docs.quran.foundation/docs/user_related_apis_versioned/tags-controller-find) - [Update a goal](https://api-docs.quran.foundation/docs/user_related_apis_versioned/update-a-goal) - [Update collection](https://api-docs.quran.foundation/docs/user_related_apis_versioned/update-collection) - [Update note by ID](https://api-docs.quran.foundation/docs/user_related_apis_versioned/update-note-by-id) - [User-related APIs](https://api-docs.quran.foundation/docs/user_related_apis_versioned/user-related-apis) - [Delete user account permanently](https://api-docs.quran.foundation/docs/user_related_apis_versioned/users-controller-delete-account) - [Edit user profile](https://api-docs.quran.foundation/docs/user_related_apis_versioned/users-controller-edit-profile) - [Follow all featured users](https://api-docs.quran.foundation/docs/user_related_apis_versioned/users-controller-follow-featured-users) - [Get featured users for follow recommendation](https://api-docs.quran.foundation/docs/user_related_apis_versioned/users-controller-get-featured-users) - [Get user followers](https://api-docs.quran.foundation/docs/user_related_apis_versioned/users-controller-get-user-followers) - [Get users followed by user](https://api-docs.quran.foundation/docs/user_related_apis_versioned/users-controller-get-user-following) - [Get user profile by id or username](https://api-docs.quran.foundation/docs/user_related_apis_versioned/users-controller-get-user-profile) - [Get user profile](https://api-docs.quran.foundation/docs/user_related_apis_versioned/users-controller-profile) - [Remove a follower](https://api-docs.quran.foundation/docs/user_related_apis_versioned/users-controller-remove-follower) - [Get logged-in user rooms](https://api-docs.quran.foundation/docs/user_related_apis_versioned/users-controller-rooms) - [Search for users](https://api-docs.quran.foundation/docs/user_related_apis_versioned/users-controller-search) - [Toggle follow/unfollow a user](https://api-docs.quran.foundation/docs/user_related_apis_versioned/users-controller-toggle-follow) - [Update user profile](https://api-docs.quran.foundation/docs/user_related_apis_versioned/users-controller-update-profile) ## OAuth2 APIs v1 - [OpenID Connect Userinfo](https://api-docs.quran.foundation/docs/oauth2_apis_versioned/get-oidc-user-info) - [Introspect OAuth2 Access and Refresh Tokens](https://api-docs.quran.foundation/docs/oauth2_apis_versioned/introspect-o-auth-2-token) - [OAuth 2.0 Authorize Endpoint](https://api-docs.quran.foundation/docs/oauth2_apis_versioned/o-auth-2-authorize) - [OAuth2 APIs](https://api-docs.quran.foundation/docs/oauth2_apis_versioned/oauth-2-apis) - [The OAuth 2.0 Token Endpoint](https://api-docs.quran.foundation/docs/oauth2_apis_versioned/oauth-2-token-exchange) - [OpenID Connect Logout](https://api-docs.quran.foundation/docs/oauth2_apis_versioned/revoke-oidc-session) ## Search APIs v1 - [Quran.Foundation Search API](https://api-docs.quran.foundation/docs/search_apis_versioned/quran-foundation-search-api) - [Search Quran content](https://api-docs.quran.foundation/docs/search_apis_versioned/search-controller-search) - [Search](https://api-docs.quran.foundation/docs/search_apis_versioned/search) ## Tutorials - [Frequently Asked Questions](https://api-docs.quran.foundation/docs/tutorials/faq) - [Integrating Quran Font Rendering](https://api-docs.quran.foundation/docs/tutorials/fonts/font-rendering) - [Page Layout API Guide](https://api-docs.quran.foundation/docs/tutorials/fonts/page-layout) - [OAuth2 Client Configuration](https://api-docs.quran.foundation/docs/tutorials/oidc/client-setup) - [OAuth2 Web Integration Example](https://api-docs.quran.foundation/docs/tutorials/oidc/example-integration) - [Using OAuth 2.0 to Access Quran.Foundation APIs](https://api-docs.quran.foundation/docs/tutorials/oidc/getting-started-with-oauth2) - [Android](https://api-docs.quran.foundation/docs/tutorials/oidc/mobile-apps/android) - [iOS](https://api-docs.quran.foundation/docs/tutorials/oidc/mobile-apps/iOS) - [React Native](https://api-docs.quran.foundation/docs/tutorials/oidc/mobile-apps/react-native) - [OpenID Connect](https://api-docs.quran.foundation/docs/tutorials/oidc/openid-connect) - [⚡ User APIs Quick Start](https://api-docs.quran.foundation/docs/tutorials/oidc/user-apis-quickstart) ## JavaScript SDK - [SDKs](https://api-docs.quran.foundation/sdk) - [Audio API](https://api-docs.quran.foundation/sdk/javascript/audio) - [Chapters API](https://api-docs.quran.foundation/sdk/javascript/chapters) - [JavaScript SDK](https://api-docs.quran.foundation/sdk/javascript) - [Juzs API](https://api-docs.quran.foundation/sdk/javascript/juzs) - [Resources API](https://api-docs.quran.foundation/sdk/javascript/resources) - [Search API](https://api-docs.quran.foundation/sdk/javascript/search) - [Migration Guide](https://api-docs.quran.foundation/sdk/javascript/migration) - [Verses API](https://api-docs.quran.foundation/sdk/javascript/verses)