Takbeer Time API

Create an email/password account and return { token, user }. If a dev-created user exists without a password, this claims the account; Google-only or deleted accounts return 409.

{
  "email": "[email protected]",
  "password": "at-least-8-characters",
  "fullName": "User Name"
}

Sign in with email/password and return { token, user }.

{ "email": "[email protected]", "password": "..." }

Exchange a Firebase Google sign-in ID token for the same Takbeer Time app JWT used by email/password auth.

{ "idToken": "firebase-google-id-token" }

Latest active masjids added to the directory. Returns up to 12 records for "recently added" widgets and community dashboards.

Find masjids within a radius of a coordinate, sorted by distance. The active prayer schedule is included on each result so you can label markers without a second round-trip.

Query params

Example

curl "https://takbeertime.com/api/mosques/nearby?lat=33.7295&lng=73.0372&radius=5000"

Paginated, filterable list. Use this when you don't have coordinates — e.g. to enumerate all masjids in a city.

Query params

Full masjid record: location, amenities, the active prayer schedule, the ranked keepers list, and the effective times for the calling user (their preferred keeper, or the top-rated keeper if no preference set).

Response (excerpt)

{
  "id": "...",
  "name": "Faisal Mosque",
  "latitude": 33.7295,
  "longitude": 73.0372,
  "city": "Islamabad",
  "country": "Pakistan",
  "amenities": ["parking", "wudhu", "women_section"],
  "prayerSchedules": [{
    "timings": { "fajr": "05:00", "dhuhr": "13:30", "maghribOffset": 3, ... },
    "verificationStatus": "verified"
  }],
  "keepers": [...],
  "effectiveTimings": { "fajr": "05:00", ... },
  "effectiveKeeperId": "...",
  "effectiveKeeperName": "..."
}

Ranked list of contributors who've submitted timings for this masjid. Each keeper's rating is computed as voteScore × recencyWeight × verifiedBoost × repBoost × keeperBoost. The top-rated keeper's submission is the default for users who haven't picked otherwise.

Per-prayer consensus over recent submissions. Shows the time, confidence (0..1), and contributor count for each prayer. Useful for masjids that don't yet have an active schedule — surface "the community thinks Fajr is around 05:00 (62% confidence)" instead of nothing.

Paginated reviews for a masjid. Sorted by helpful-count then recency.

Add a new masjid to the directory. The caller must be signed in; abuse is rate-limited.

Body

{
  "name": "Masjid Al-Falah",
  "latitude": 33.7295,
  "longitude": 73.0372,
  "city": "Islamabad",
  "country": "Pakistan",
  "addressLine1": "Block 4, Garden Town"   // optional
}

Edit a masjid created by the authenticated user. Returns 403 if another contributor owns the masjid record.

Body

Any field accepted by POST /mosques may be sent as a partial update. If either coordinate changes, send both latitude and longitude.

Create or update the authenticated user's review for a masjid.

{
  "rating": 5,
  "timingAccuracyRating": 5,
  "cleanlinessRating": 4,
  "accessibilityRating": 4,
  "title": "Reliable timings",
  "reviewText": "The posted jamaat times match the board."
}

Toggle: if not already favorited, save it; if already, remove. Returns { favorite: true|false }.

Paginated submissions, filterable by masjid id and status.

Query params

A single submission with the contributor's profile (name, reputation, verified flag).

Submit timings for a masjid. After creation the consensus pipeline runs — your submission may immediately become the active schedule if confidence is high enough.

Body

{
  "mosqueId": "uuid",
  "timings": {
    "fajr":   "05:00",
    "dhuhr":  "13:30",
    "asr":    "17:00",
    "isha":   "20:00",
    "jummah": ["13:30"],
    "maghribOffset": 3        // minutes after astronomical sunset
  },
  "notes": "winter schedule"  // optional
}

Up- or down-vote a submission. Voting on your own submission returns 400.

Body

{ "voteType": "upvote" | "downvote" | "report",
  "reportReason": "..."  // required when voteType is "report" }

Verified contributors can approve or reject a pending timing submission. Approval installs a verified active schedule and rewards the submitter.

Body

{
  "action": "approve" | "reject",
  "reviewNotes": "Checked against the masjid board"
}

Send a suggestion to a specific keeper (the user whose timings are currently active for the masjid, or anyone in the keeper list).

Body

{
  "toUserId": "uuid",        // recipient keeper
  "mosqueId": "uuid",
  "timings":  { "fajr": "05:16", "maghribOffset": 5 },
  "notes":    "Ramadan schedule starts tomorrow"
}

Pending suggestions sent to the authenticated user. Each suggestion includes the sender, the masjid, the proposed times, AND the masjid's current active timings — so a UI can render an old → new diff in one round-trip.

Mark accepted, install the proposed timings on the masjid's active schedule (merged over current values), and create a TimingSubmission as the keeper for the audit trail. Returns 403 if the calling user isn't the recipient.

Mark declined with optional note. No schedule change.

Body

{ "note": "These times are wrong, please re-check" }  // optional

The authenticated user's profile, default mosque, and counts.

Update profile fields.

Body (all optional)

{
  "fullName":         "Junaid Qazi",
  "phoneNumber":      "+92...",
  "preferredLanguage": "ur",
  "defaultMosqueId":   "uuid"   // null clears it
}

Paginated list of mosques the user has favorited.

Set or clear the user's preferred keeper for one masjid. The masjid detail's effectiveTimings use this keeper's submission when set.

{ "mosqueId": "uuid", "keeperUserId": "uuid" | null }

Mirror the user's reminder preferences server-side so they sync across devices.

{
  "enabled":       true,
  "perPrayer":     { "fajr": 10, "dhuhr": 10, "asr": 10, "maghrib": 10, "isha": 10, "jummah": 0 },
  "prayerEnabled": { "fajr": true, "dhuhr": true, ... }
}

Paginated notifications (timing changes, new keepers, etc.). Add ?unread=true to filter.

Mark one notification as read. Returns 404 if the notification does not belong to the authenticated user.

Mark all unread notifications for the authenticated user as read. Returns { marked: number }.

Self-service account deletion. Soft-deletes the user, clears favorites and reminder preferences, removes sent pending suggestions, and keeps community timing submissions for continuity.

Paginated list of schedules across masjids.

A single schedule with its verifier and contributor.

The currently active schedule for a masjid. 404 if the masjid has none.

Auth-less account deletion request for users who cannot access the app. The response does not reveal whether the email belongs to an account.

{
  "email": "[email protected]",
  "reason": "I can no longer access the app"
}