Juzs API

The Juzs API provides information about the 30 Juzs, which are traditional divisions of the Quran.

Get All Juzs

const juzs = await client.juzs.findAll();

console.log(juzs[0]); // First Juz
// {
//   id: 1,
//   juzNumber: 1,
//   verseMapping: {
//     "1:1": "1:7",
//     "2:1": "2:141"
//   },
//   firstVerseId: 1,
//   lastVerseId: 148,
//   versesCount: 148
// }

Juz Type

Field	Type	Notes
id	number	Unique identifier for the Juz.
juzNumber	number	Juz sequence from 1 to 30.
verseMapping	Record<string, string>	Maps start/end verse keys for each section within the Juz.
firstVerseId	number	Identifier of the first verse in the Juz.
lastVerseId	number	Identifier of the last verse in the Juz.
versesCount	number	Total verses contained in the Juz.

Understanding Verse Mapping

const juz = juzs[0];

Object.entries(juz.verseMapping).forEach(([start, end]) => {
  console.log(`${start} to ${end}`);
});

// Output:
// 1:1 to 1:7     (Al-Fatiha complete)
// 2:1 to 2:141   (First part of Al-Baqarah)