{"openapi":"3.1.0","info":{"title":"Prayer Times & Islamic Calendar API","version":"1.0.0","description":"Islamic prayer times, the Hijri calendar and the Qibla direction as an API. Get the five daily prayer times — Fajr, Dhuhr, Asr, Maghrib and Isha, plus sunrise, sunset, Imsak and midnight — for any coordinate and date, calculated with your choice of method (Muslim World League, ISNA, Umm al-Qura, Egyptian, and many more), alongside the matching Hijri date; convert any date between the Gregorian and Hijri (Islamic lunar) calendars in either direction; and get the exact Qibla direction — the compass bearing and great-circle distance from any location to the Kaaba in Mecca. Prayer times and calendar conversion are powered by the Aladhan service; the Qibla is computed directly. Ideal for Muslim prayer and lifestyle apps, mosque and community sites, Ramadan tools and calendars, and any app that needs accurate prayer times or Hijri dates. Open data.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/prayer-api","description":"oanor gateway"}],"tags":[{"name":"Prayer Times"},{"name":"Calendar"},{"name":"Qibla"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/timings":{"get":{"operationId":"get_v1_timings","tags":["Prayer Times"],"summary":"Daily prayer times","description":"","parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude (-90..90)","schema":{"type":"string"},"example":"21.42"},{"name":"lon","in":"query","required":true,"description":"Longitude (-180..180)","schema":{"type":"string"},"example":"39.83"},{"name":"date","in":"query","required":false,"description":"Date (YYYY-MM-DD or DD-MM-YYYY), default today","schema":{"type":"string"}},{"name":"method","in":"query","required":false,"description":"Calculation method 0-23 (default 3 = Muslim World League)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"timings":{"date":{"hijri":{"day":"14","date":"14-12-1447","year":"1447","month":"Dhū al-Ḥijjah","weekday":"Al Ahad","month_ar":"ذوالحجة","designation":"AH","month_number":12},"gregorian":"31-05-2026"},"method":"Muslim World League","location":{"lat":21.42,"lon":39.83,"timezone":"Asia/Riyadh"},"prayer_times":{"Asr":"15:34","Fajr":"04:14","Isha":"20:18","Dhuhr":"12:18","Imsak":"04:04","Sunset":"18:59","Maghrib":"18:59","Sunrise":"05:38","Midnight":"00:18"}}},"meta":{"timestamp":"2026-05-31T15:30:51.041Z","request_id":"97cd5433-4f7c-4ee0-9c61-77955c771ec9"},"status":"ok","message":"Timings retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/convert":{"get":{"operationId":"get_v1_convert","tags":["Calendar"],"summary":"Convert Gregorian ⇄ Hijri date","description":"","parameters":[{"name":"date","in":"query","required":true,"description":"Date (YYYY-MM-DD or DD-MM-YYYY)","schema":{"type":"string"},"example":"2026-06-01"},{"name":"from","in":"query","required":false,"description":"gregorian | hijri (default gregorian)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"conversion":{"from":"gregorian","hijri":{"day":"15","date":"15-12-1447","year":"1447","month":"Dhū al-Ḥijjah","weekday":"Al Athnayn","month_ar":"ذوالحجة","designation":"AH","month_number":12},"input":"01-06-2026","gregorian":{"day":"01","date":"01-06-2026","year":"2026","month":"June","weekday":"Monday","month_number":6}}},"meta":{"timestamp":"2026-05-31T15:30:51.136Z","request_id":"fdc25ac3-a7a6-4742-ae29-7139b751f775"},"status":"ok","message":"Date converted","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/qibla":{"get":{"operationId":"get_v1_qibla","tags":["Qibla"],"summary":"Qibla direction & distance","description":"","parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude (-90..90)","schema":{"type":"string"},"example":"48.2"},{"name":"lon","in":"query","required":true,"description":"Longitude (-180..180)","schema":{"type":"string"},"example":"16.4"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"qibla":{"note":"Direction (true-north bearing) and great-circle distance from your location to the Kaaba in Mecca.","kaaba":{"lat":21.4225,"lon":39.8262},"compass":"SE","location":{"lat":48.2,"lon":16.4},"distance_km":3635,"direction_deg":136.74}},"meta":{"timestamp":"2026-05-31T15:30:51.219Z","request_id":"32310257-b15b-4daa-b7d5-9e892d30c78d"},"status":"ok","message":"Qibla retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Calculation methods & options","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Islamic prayer times, Hijri ⇄ Gregorian date conversion and Qibla direction. /v1/timings = the five daily prayers (+ sunrise, imsak, midnight) for a coordinate and date (default today), with the Hijri date and a calculation method; /v1/convert = convert a date between the Gregorian and Hijri calendars (from=gregorian|hijri); /v1/qibla = the compass direction & distance to the Kaaba. Dates accept YYYY-MM-DD or DD-MM-YYYY.","source":"Aladhan API (prayer times & Islamic calendar) + local Qibla calculation","endpoints":["/v1/timings","/v1/convert","/v1/qibla","/v1/meta"],"calculation_methods":{"0":"Shia Ithna-Ansari","1":"University of Islamic Sciences, Karachi","2":"ISNA","3":"Muslim World League (default)","4":"Umm al-Qura, Makkah","5":"Egyptian General Authority","7":"Institute of Geophysics, Tehran","8":"Gulf Region","9":"Kuwait","10":"Qatar","11":"Singapore","12":"France","13":"Turkey","99":"Custom"}},"meta":{"timestamp":"2026-05-31T15:30:51.295Z","request_id":"a0c88eae-4fc2-435a-98fb-278b6dab816a"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3640,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":415,"monthly_call_quota":49200,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1265,"monthly_call_quota":244000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3355,"monthly_call_quota":1200000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/prayer-api"}