Free & Comprehensive

Free Hadith API for Developers

Access 36,000+ hadiths from 10 collections including Sahih Bukhari, Sahih Muslim, and Sunan Abu Dawud. Full-text search, random hadith, and grading info. No API key required.

Read the Docs Try it Live

Quick Start

Get a hadith from Sahih Bukhari:

JavaScript const res = await fetch('https://ummahapi.com/api/hadith/bukhari/1'); const data = await res.json(); // Returns the hadith with full metadata console.log(data.data.hadith_english); // The narration text console.log(data.data.book); // Book name console.log(data.data.grade); // "Sahih"

What You Get

10 Collections

Sahih Bukhari, Sahih Muslim, Abu Dawud, Tirmidhi, Nasa'i, Ibn Majah, and Muwatta Malik.

36,000+ Hadiths

The largest free hadith API available. Each hadith includes Arabic text, English translation, narrator chain, book, and chapter info.

Full-Text Search

Search across all collections by keyword. Find hadiths about any topic — prayer, fasting, charity, marriage, and more.

Grading Info

Each hadith includes its authenticity grading (Sahih, Hasan, Da'if) from recognized scholars, where available.

Random Hadith

Get a random hadith for daily reminders, widgets, or apps. Filter by collection for targeted results.

Arabic + English

Every hadith includes both the original Arabic text and English translation side by side.

Endpoints

GET /api/hadith/{collection}/{number} Get a specific hadith
GET /api/hadith/collections List all 10 collections
GET /api/hadith/search?q={query} Search all hadiths
GET /api/hadith/random Random hadith

Frequently Asked Questions

Is the Hadith API free?

Yes. UmmahAPI's Hadith API is completely free with no API key required. You can make up to 100 requests per minute. For higher limits, register for a free API key.

What hadith collections are available?

The API includes 10 collections: Sahih Bukhari, Sahih Muslim, Sunan Abu Dawud, Jami at-Tirmidhi, Sunan an-Nasa'i, Sunan Ibn Majah, Muwatta Malik, Nawawi's 40 Hadith, 40 Hadith Qudsi, and Shah Waliullah's 40 Hadith. Use /api/hadith/collections to see the full list.

Can I search hadiths by keyword?

Yes. The /api/hadith/search?q=prayer endpoint lets you search across all 36,000+ hadiths by keyword. Results include the hadith text, collection, book, number, and grading.

Does the Hadith API include grading information?

Yes. Each hadith includes its grading (Sahih, Hasan, Da'if, etc.) from recognized scholars, where available. This helps you filter by authenticity in your application.

Related Resources

More Free Islamic APIs

Start building with the Hadith API

36,000+ hadiths from 10 collections. Free forever.

View Full Documentation