Sajda

About sajdah data

QUL exports Sajdah data(list of ayah where Sajdah is prescribed) in both JSON and SQLite formats. Each record includes the ayah key, sajdah number, and whether the sajdah is optional or required.

Sample JSON

{
  "1": {
    "sajdah_number": 1,
    "verse_key": "7:206",
    "sajdah_type": "optional"
  }
}

Field descriptions

How to use this resource

Download the JSON or SQLite file from the download links on this page. The JSON file is one object: each key is the sajdah_number as a string ("1" to "15"). The SQLite file has the same fields in the sajdah table.

• Find the ayah. Use verse_key (surah:ayah) to find the ayah in the other QUL resources: text, translation or audio.
• Filter by type. sajdah_type is "required" or "optional" (see the field table above). Filter on it to show only the required prostrations.

// Setup: unzip the download and serve quran-metadata-sajda.json from your app (here at /data/)
const sajdahs = await fetch('/data/quran-metadata-sajda.json').then((res) => res.json());

// Verse keys of the required sajdahs
const required = Object.values(sajdahs)
  .filter((sajdah) => sajdah.sajdah_type === 'required')
  .map((sajdah) => sajdah.verse_key);

// Check whether an ayah has a sajdah
const byVerseKey = new Map(Object.values(sajdahs).map((sajdah) => [sajdah.verse_key, sajdah]));
byVerseKey.has('7:206'); // true

-- SQLite: the same fields are in the sajdah table
SELECT sajdah_number, verse_key, sajdah_type
FROM sajdah
ORDER BY sajdah_number;

To get the text of these ayahs, see the Quran Script resources.