⚡ IUIR Open API

Indian Islamic Prayer Time API

اوقات الصلوة — Developer Documentation

Is method ko ek API ke taur par launch karein taaki India ke baaki apps bhi aapka "Indian Unified Islamic Research (IUIR)" method apne settings mein option ke taur par de sakein.

v1.0 StableREST APIJSON ResponseFree for Islamic AppsIndia + Global

📐 Technical Specification — Calculation Parameters

School of Thought / Maslak	Fajr Angle	Dhuhr	Asr Method	Maghrib (Iftar)	Isha Angle	IUIR Code
🇮🇳 Indian Islamic (IUIR Default) اسلامیہ ہند	15°	Zawaal + 0 min	Hanafi (2× shadow)	Sunset 0° (Immediate)	15°	`indian_islamic`
☀️ Sunni — Hanafi حنفی	18°	Zawaal + 0 min	Hanafi (2× shadow)	Sunset 0°	18°	`sunni_hanafi`
☀️ Sunni — Shafi / Maliki / Hanbali شافعی / مالکی / حنبلی	18°	Zawaal + 0 min	Standard (1× shadow)	Sunset 0°	17°	`sunni_standard`
📿 Ahle Hadith اہل حدیث	15°	Zawaal + 0 min	Standard (1× shadow)	Sunset 0°	15°	`ahle_hadith`
🌙 Shia Jafari جعفری	16°	Zawaal + 0 min	Standard (1× shadow)	Sunset + 4° (Twilight ends)	14°	`shia_jafari`
UIS Karachi (Standard India)	18°	Zawaal + 0 min	Hanafi (2× shadow)	Sunset 0°	18°	`uis_karachi`
Muslim World League (MWL)	18°	Zawaal + 0 min	Standard (1× shadow)	Sunset 0°	17°	`mwl`

🌐 Base URL & Authentication

https://api.starhindis.com/iuir/v1

Authentication: Bearer token required for write operations. Read operations (prayer times) are free and open.

Request Headers

# Request Headers
Authorization: Bearer YOUR_API_KEY
Content-Type:  application/json
X-IUIR-Version: 1.0

⚡ API Endpoints

GET/prayer-times

Get prayer times for any city in India or by coordinates

Parameters

citystringCity name (e.g. "Vijayawada") OR use lat/lng

statestringState name (optional, helps disambiguation)

latfloatLatitude coordinate (e.g. 16.5062)

lngfloatLongitude coordinate (e.g. 80.6480)

methodstringCalculation method code (default: indian_islamic)

madhabstringhanafi / shafi / maliki / hanbali / ahle_hadith / jafari

datestringYYYY-MM-DD format (default: today)

Example Request

GET https://api.starhindis.com/iuir/v1/prayer-times
  ?city=Vijayawada
  &state=Andhra+Pradesh
  &method=indian_islamic
  &madhab=hanafi
  &date=2026-03-23

Response — 200 OK

{
  "status": "success",
  "method": "indian_islamic",
  "madhab": "hanafi",
  "city": "Vijayawada",
  "state": "Andhra Pradesh",
  "country": "India",
  "coordinates": { "lat": 16.5062, "lng": 80.6480 },
  "date": {
    "gregorian": "2026-03-23",
    "hijri": "2 Shawwal 1447"
  },
  "calculation_params": {
    "fajr_angle": 15,
    "isha_angle": 15,
    "asr_factor": 2,
    "maghrib": "sunset",
    "high_lat_rule": "none"
  },
  "prayer_times": {
    "fajr":    "04:59 AM",
    "sunrise": "06:11 AM",
    "dhuhr":   "12:20 PM",
    "asr":     "04:19 PM",
    "maghrib": "06:25 PM",
    "isha":    "07:37 PM"
  },
  "sehri_end": "04:59 AM",
  "iftar":    "06:25 PM",
  "qibla_degree": 276.5,
  "timezone": "Asia/Kolkata",
  "credit": "Indian Islamic Prayer Time — Mohammad Ishaq · StarHindis.com"
}

GET/prayer-times/monthly

Get full month prayer timetable — ideal for printing masjid calendars

GET/masjids

List verified masjids/madrasas. Filter by city, state, madhab, type.

POST/masjids/register

GET/methods

List all available calculation methods with their parameters — useful for app settings screens.

📱 Integration Examples

JavaScript / React Native

const response = await fetch(
  `https://api.starhindis.com/iuir/v1
  /prayer-times?city=${city}
  &method=indian_islamic
  &madhab=hanafi`
);
const data = await response.json();
// data.prayer_times.fajr → "04:59 AM"

Python

import requests

res = requests.get(
  "https://api.starhindis.com"
  "/iuir/v1/prayer-times",
  params={
    "city": "Lucknow",
    "method": "indian_islamic",
    "madhab": "hanafi"
  }
)
times = res.json()["prayer_times"]

🚀 Apne App Mein IUIR Method Kaise Add Karein

Step 1 — Method List Mein Add Karein

Apni calculation method dropdown mein "Indian Islamic (IUIR)" ko pehla aur default option banayein. Method code: indian_islamic

Step 2 — Parameters Set Karein

Fajr = 15° · Isha = 15° · Asr = Hanafi (2×) for Hanafi madhab users, Standard (1×) for others · Maghrib = Sunset 0°

Step 3 — Credit Dein

Method name mein likha ho: Indian Islamic Prayer Time — IUIR
Link: StarHindis.com

Step 4 — API Use Karein (Optional)

Free API key ke liye: api@starhindis.com
Islamic apps ke liye bilkul free · No rate limit for verified apps

Partnership Program

Agar aap apne app mein IUIR method add karein toh IUIR Partner Badge milega. Aapka app hamari website par listed hoga — free promotion for Islamic apps.

اللَّهُمَّ تَقَبَّلْ مِنَّا

Indian Islamic Prayer Time (IUIR)
Prepared by Mohammad Ishaq
Founder — StarBayt Investment Limited (India & Zambia)
Creator — Star Hindis · StarHindis.com
Director — Serenje Ferro Alloys Limited, Zambia
In collaboration with Madaris & Masajid across India