API Reference

Complete reference for all Mumin Hadith API endpoints.

Base URL

https://api.mumin.ink/v1

Authentication

All endpoints require an API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key from dashboard.mumin.ink (opens in a new tab)

Endpoints

Hadiths

• Get Hadith by ID - Retrieve a single hadith
• List Hadiths - Get paginated list
• Search Hadiths - Full-text search
• Random Hadith - Get random hadith
• Daily Hadith - Featured daily hadith

Collections

• List Collections - Get all collections
• Get Collection - Detailed metadata

Books

• List Books - Get all books

Rate Limits

• 100 requests per minute per API key
• 1,000 requests per hour per IP address

See Rate Limits for details.

Error Codes

All errors follow a consistent format. See Error Codes for complete list.

Response Format

All successful responses return JSON:

{
  "id": 1,
  "collection": "Sahih al-Bukhari",
  "collectionId": 1,
  "bookNumber": 1,
  "hadithNumber": 1,
  "arabicText": "...",
  "translation": {
    "text": "...",
    "languageCode": "en"
  }
}

Quick Links