API Reference

The Quranic CMS API is a REST API for Quranic recitation data — reciters, recitations, riwayat, qira'at, and ayah-level audio timings from verified publishers. Base URL: https://staging.api.cms.itqan.dev.

Quick links

Quickstart	Make your first API call in under a minute
API Guides	Design conventions, pagination, localization, and more
Authentication	OAuth 2 token endpoints (for privileged operations)

Conventions

• Response shape — Response Structure: all list endpoints return {count, results}.
• Pagination — Pagination: page and page_size params, default 20, max 1 000.
• Localization — Localization: pass Accept-Language: ar for Arabic text in all name/bio fields.
• Errors — Error Handling: every non-2xx response uses {error_name, message, extra}.

Resource groups

Reciters — Verified Quran reciters with name, bio, and recitation count. Start with List Reciters.

Recitations — Full recitation records linking a reciter, riwayah, qiraah, and publisher. Each includes surah-level track counts. Start with List Recitations.

Recitation Tracks — Surah-level audio track entries for a given recitation, including ayah timings. Start with List Recitation Tracks.

Riwayahs — Narration chains (e.g. Hafs an Asim, Warsh). Start with List Riwayahs.

Authentication — Token issuance and revocation for authenticated operations. See the Authentication guide.