Skip to content

Request for API access: Safa #3098

@muslimah-app

Description

@muslimah-app

We are building Safa — a privacy-first Islamic companion app
for Muslim women worldwide. The app is built with React Native
(Expo) and is currently in development, participating in the
Quran Foundation Hackathon 2026 (submission deadline May 20).

  • Your purpose in using this API:
    Safa displays a daily hadith curated for Muslim women, rotating
    through 7 themes by day of week (patience, gratitude, family,
    night prayer, Jumaa, knowledge, tawbah/reflection).

We currently have hardcoded hadith references from Kutub
Al-Sittah but want to replace all hardcoded Arabic text with
live fetches from Sunnah.com to ensure:

  1. Authenticity — exact verified Arabic text and translation
  2. Accuracy — correct narrator chains and grading
  3. Updatability — if Sunnah.com corrects or updates content,
    Safa stays accurate automatically

Each hadith is displayed with full Arabic text, narrator,
English translation, source reference, and a direct link back
to sunnah.com for the full entry. We give full attribution to
Sunnah.com throughout the app.

We fetch one hadith per day per user, heavily cached in
AsyncStorage so the same hadith is not re-fetched within
the same day.

  • API rate limits:
    maximum requests per second = 1
    maximum requests per day = 100

  • Is your use case better served by having an offline dump of hadith data or programmatic API access?
    API access — we fetch and cache aggressively (each hadith
    cached indefinitely in AsyncStorage since hadith text does
    not change). A user will trigger at most 1 new API call
    per day for the daily hadith, and additional calls only
    when browsing hadiths by theme. An offline dump would also
    be acceptable and would reduce our API dependency if that
    is easier for the Sunnah.com team.

  • What are the languages in which would you like hadith data?
    Arabic and English

  • What programming language will your API client be in?
    TypeScript / JavaScript (React Native / Expo mobile app)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions