Back
    IslamiCloudAPI Documentation
    Postman

    🕌 One Platform, One Subscription — All 10 API modules below are included in every IslamiCloud plan. Subscribe once per app and access Hadiths, Prayer Times, Qibla, Adhan, Mosques, Media, Radio, Azkar, Images and more.

    Authentication

    All endpoints require a Bearer token (API key) in the Authorization header. Create and manage keys in the Dashboard.

    Authorization: Bearer YOUR_API_KEY

    Base URL

    {{baseUrl}}/api

    Success Response

    { "code": 200, "status": "OK", "data": ... }

    Error Response

    { "error": "message" } with 400/401/403/404/500

    Hadiths

    /api/hadiths

    Hadith editions, day hadith, categories, list, and single hadith by id.

    Info

    GEThadiths/info?book={{book}}

    Get info (one book)

    Returns info for a single book.

    Parameters

    NameDescriptionRequired
    bookBook slug (e.g. bukhari, abudawud, muslim)Required

    Example Request

    curl -H 'Authorization: Bearer YOUR_KEY' 'https://api.islamicloud.com/api/hadiths/info?book=bukhari'
    GEThadiths/info

    Get info (all books)

    Returns info for all available hadith books.

    Example Request

    curl -H 'Authorization: Bearer YOUR_KEY' https://api.islamicloud.com/api/hadiths/info

    Hadith of the day

    GEThadiths/day

    Hadith of the day (today, default lang)

    Returns hadith of the day for today in default language (en). Response includes hadith, source (edition, book, section, reference_label), lang, date, day_of_year, supported_languages.

    Example Request

    curl -H 'Authorization: Bearer YOUR_KEY' https://api.islamicloud.com/api/hadiths/day
    GEThadiths/day?lang=en&date=2022-09-21

    Hadith of the day (lang + date)

    Returns hadith of the day for a given language and date.

    Parameters

    NameDescriptionRequired
    langLanguage code (e.g. en, ar). Use codes from List edition languages.Optional
    dateYYYY-MM-DD (optional, default: today)Optional

    Example Request

    curl -H 'Authorization: Bearer YOUR_KEY' 'https://api.islamicloud.com/api/hadiths/day?lang=en&date=2022-09-21'

    Edition content

    GEThadiths/editions/:editionName

    Get full edition

    Returns full edition content: metadata (name, sections, section_details) and all hadiths.

    Parameters

    NameDescriptionRequired
    editionNamee.g. eng-bukhari, ara-bukhariRequired

    Example Request

    curl -H 'Authorization: Bearer YOUR_KEY' https://api.islamicloud.com/api/hadiths/editions/eng-bukhari
    GEThadiths/editions/:editionName/:hadithNo

    Get one hadith (by edition + number)

    Returns a single hadith by edition name and hadith number.

    Parameters

    NameDescriptionRequired
    editionNamee.g. eng-bukhariRequired
    hadithNoPositive integer (e.g. 51)Required

    Example Request

    curl -H 'Authorization: Bearer YOUR_KEY' https://api.islamicloud.com/api/hadiths/editions/eng-bukhari/51
    GEThadiths/:editionName/:hadithNo

    Get one hadith (short URL)

    Same as above but with short path: /api/hadiths/:editionName/:hadithNo.

    Parameters

    NameDescriptionRequired
    editionNamee.g. eng-bukhariRequired
    hadithNoe.g. 51Required

    Example Request

    curl -H 'Authorization: Bearer YOUR_KEY' https://api.islamicloud.com/api/hadiths/eng-bukhari/51
    GEThadiths/editions/:editionName/sections/:sectionNo

    Get section hadiths

    Returns all hadiths in one section of an edition.

    Parameters

    NameDescriptionRequired
    editionNamee.g. eng-bukhariRequired
    sectionNoSection key (e.g. 1, 2)Required

    Example Request

    curl -H 'Authorization: Bearer YOUR_KEY' https://api.islamicloud.com/api/hadiths/editions/eng-bukhari/sections/1
    GEThadiths/editions/:editionName/hadiths?page=1&limit=20

    List hadiths (paginated)

    Paginated list of hadiths for an edition.

    Parameters

    NameDescriptionRequired
    pagePage number (default 1)Optional
    limitItems per page (default 20, max 100)Optional

    Example Request

    curl -H 'Authorization: Bearer YOUR_KEY' 'https://api.islamicloud.com/api/hadiths/editions/eng-bukhari/hadiths?page=1&limit=20'

    Editions & Languages

    GEThadiths/editions

    List all editions

    Lists all available hadith editions (books and their language variants). Data keyed by book slug with name and collection array.

    Example Request

    curl -H 'Authorization: Bearer YOUR_KEY' https://api.islamicloud.com/api/hadiths/editions
    GEThadiths/editions/languages

    List edition languages

    Returns supported languages for hadith editions. Use code in ?lang= for hadith of the day.

    Example Request

    curl -H 'Authorization: Bearer YOUR_KEY' https://api.islamicloud.com/api/hadiths/editions/languages