Back to explorereligion

Sunnah

Traditions and practices of the Islamic prophet, Muhammad (pbuh)

Books

Get a list of books from within a collection. A book can contain many chapters each with its own hadiths.

Price: Free

Request Payload

collectionstring

Name of the collection

limitnumber

Limit the number of books returned

pagenumber

The page in the pagination

Response

booksarray

A list of books

collectionstring

Name of the collection

limitnumber

The limit specified

pagenumber

The page requested

totalnumber

The total overall books

Request

Response

1{
2    "collection": "bukhari",
3    "total": 97,
4    "page": 1,
5    "limit": 50,
6    "books": [
7        {
8            "id": 1,
9            "name": "Revelation",
10            "arabic_name": "كتاب بدء الوحى ",
11            "hadiths": 7
12        },
13        {
14            "id": 2,
15            "name": "Belief",
16            "arabic_name": "كتاب الإيمان ",
17            "hadiths": 51
18        },
19        {
20            "id": 3,
21            "name": "Knowledge",
22            "arabic_name": "كتاب العلم ",
23            "hadiths": 76
24        }
25    ]
26}

Chapters

Get all the chapters of a given book within a collection.

Price: Free

Request Payload

booknumber

number of the book

collectionstring

name of the collection

limitnumber

Limit the number of chapters returned

pagenumber

The page in the pagination

Response

booknumber

number of the book

chaptersarray

The chapters of the book

collectionstring

name of the collection

limitnumber

Limit the number of chapters returned

pagenumber

The page in the pagination

totalnumber

Total chapters in the book

Request

Response

1{
2    "collection": "bukhari",
3    "book": 1,
4    "page": 1,
5    "limit": 50,
6    "total": 6,
7    "chapters": [
8        {
9            "id": 1,
10            "key": "1.00",
11            "book": 1,
12            "title": "How the Divine Revelation started being revealed to Allah's Messenger",
13            "arabic_title": "باب كَيْفَ كَانَ بَدْءُ الْوَحْىِ إِلَى رَسُولِ اللَّهِ صلى الله عليه وسلم"
14        }
15    ]
16}

Collections

Get a list of available collections. A collection is a compilation of hadiths collected and written by an author.

Price: Free

Request Payload

limitnumber

Number of collections to limit to

pagenumber

The page in the pagination

Response

collectionsarray

Request

Response

1{
2    "collections": [
3        {
4            "name": "bukhari",
5            "title": "Sahih al-Bukhari",
6            "arabic_title": "صحيح البخاري",
7            "summary": "Sahih al-Bukhari is a collection of hadith compiled by Imam Muhammad al-Bukhari (d. 256 AH/870 AD) (rahimahullah).\r\n\r\nHis collection is recognized by the overwhelming majority of the Muslim world to be the most authentic collection of reports of the <i>Sunnah</i> of the Prophet Muhammad (ﷺ). It contains over 7500 hadith (with repetitions) in 97 books.\r\n\r\nThe translation provided here is by Dr. M. Muhsin Khan.",
8            "hadiths": 7291
9        }
10    ]
11}

Hadiths

Hadiths returns a list of hadiths and their corresponding text for a given book within a collection.

Price: Free

Request Payload

booknumber

number of the book

collectionstring

name of the collection

limitnumber

Limit the number of hadiths

pagenumber

The page in the pagination

Response

booknumber

number of the book

collectionstring

name of the collection

hadithsarray

The hadiths of the book

limitnumber

Limit the number of hadiths returned

pagenumber

The page in the pagination

totalnumber

Total hadiths in the book

Request

Response

1{
2    "collection": "bukhari",
3    "book": 1,
4    "page": 1,
5    "limit": 50,
6    "total": 7,
7    "hadiths": [
8        {
9            "id": 1,
10            "chapter": 1,
11            "chapter_key": "1.00",
12            "chapter_title": "How the Divine Revelation started being revealed to Allah's Messenger",
13            "arabic_chapter_title": "باب كَيْفَ كَانَ بَدْءُ الْوَحْىِ إِلَى رَسُولِ اللَّهِ صلى الله عليه وسلم",
14            "text": "<p>Narrated 'Umar bin Al-Khattab:\n</p>\n<p>\n I heard Allah's Messenger (ﷺ) saying, \"The reward of deeds depends upon the \n intentions and every person will get the reward according to what he \n has intended. So whoever emigrated for worldly benefits or for a woman\n to marry, his emigration was for what he emigrated for.\"\n</p>",
15            "arabic_text": "<p>[prematn]حَدَّثَنَا[narrator id=\"4698\" tooltip=\"عبد الله بن الزبير بن عيسى بن عبيد الله بن أسامة بن عبد الله بن حميد بن زهير بن الحارث بن أسد بن عبد العزى\"] الْحُمَيْدِيُّ عَبْدُ اللَّهِ بْنُ الزُّبَيْرِ [/narrator]، قَالَ : حَدَّثَنَا[narrator id=\"3443\" tooltip=\"سفيان بن عيينة بن ميمون\"] سُفْيَانُ [/narrator]، قَالَ : حَدَّثَنَا[narrator id=\"8272\" tooltip=\"يحيى بن سعيد بن قيس بن عمرو بن سهل بن ثعلبة بن الحارث بن زيد بن ثعلبة بن غنم بن مالك بن النجار\"] يَحْيَى بْنُ سَعِيدٍ الْأَنْصَارِيُّ [/narrator]، قَالَ : أَخْبَرَنِي[narrator id=\"6796\" tooltip=\"محمد بن إبراهيم بن الحارث بن خالد بن صخر بن عامر بن كعب بن سعد بن تيم بن مرة\"] مُحَمَّدُ بْنُ إِبْرَاهِيمَ التَّيْمِيُّ [/narrator]، أَنَّهُ سَمِعَ[narrator id=\"5719\" tooltip=\"علقمة بن وقاص بن محصن بن كلدة بن عبد ياليل\"] عَلْقَمَةَ بْنَ وَقَّاصٍ اللَّيْثِيَّ [/narrator]، يَقُولُ : سَمِعْتُ[narrator id=\"5913\" tooltip=\"عمر بن الخطاب بن نفيل بن عبد العزى بن رياح بن عبد الله بن قرط بن رزاح بن عدي بن كعب\"] عُمَرَ بْنَ الْخَطَّابِ [/narrator] رَضِيَ اللَّهُ عَنْهُ عَلَى الْمِنْبَرِ، قَالَ : سَمِعْتُ رَسُولَ اللَّهِ صَلَّى اللَّهُ عَلَيْهِ وَسَلَّمَ، يَقُولُ : \"[/prematn]\n[matn]إِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ، وَإِنَّمَا لِكُلِّ امْرِئٍ مَا نَوَى، فَمَنْ كَانَتْ هِجْرَتُهُ إِلَى دُنْيَا يُصِيبُهَا أَوْ إِلَى امْرَأَةٍ يَنْكِحُهَا، فَهِجْرَتُهُ إِلَى مَا هَاجَرَ إِلَيْهِ \"[/matn]</p>"
16        }
17    ]
18}