# AlAdhan > Islamic prayer times, the Hijri calendar and the Qibla, from the free AlAdhan API. Get a day's prayer times or the next prayer due for any city, address or set of coordinates, publish a month, a year or the whole of Ramadan as a timetable, convert dates between the Gregorian and Hijri calendars, look up Islamic holidays and special days, find the compass bearing to the Kaaba, and read the ninety-nine names of Allah. Twenty-three calculation methods are supported, along with the Hanafi Asr, high-latitude rules and per-prayer minute adjustments. No account or API key is required. App · Calendars · 22 actions. Web page: https://docs.lodol.com/docs/integrations/aladhan ## Actions ### Convert a date to the Hijri calendar Turn a Gregorian date into its Hijri one, with the day of the week in English and Arabic and any holiday that falls on it. Leave the date empty for today, so a scheduled workflow can post the Hijri date each morning with nothing filled in. **Inputs** - Date (`date`, date): The Gregorian date to convert. Leave empty for today. - Hijri calendar method (`calendar_method`, text): How a Gregorian date is turned into a Hijri one. Defaults to the High Judiciary Council of Saudi Arabia, which is what aladhan.com itself shows. Run 'List Hijri calendar methods' to see what each covers. One of: `HJCoSA` (High Judiciary Council of Saudi Arabia (default)), `UAQ` (Umm al-Qura), `DIYANET` (Diyanet Isleri Baskanligi, Turkey), `MATHEMATICAL` (Mathematical calculation). - Day adjustment (`adjustment`, number): Shift the converted Hijri date by whole days, from -5 to 5, for a local moon sighting that ran a day ahead or behind. AlAdhan applies it only under the Mathematical calendar method, so choose that method too. From -5 to 5. **Outputs** - `gregorian` (object) - `gregorian_date` (text) - `hijri` (object) - `hijri_date` (text) - `hijri_described` (text) - `holidays` (list) - `is_holiday` (true/false) - `requested_date` (text) **Example output** ```json { "gregorian": { "date": "23-08-2026", "date_iso": "2026-08-23", "day": "23", "day_number": 23, "format": "DD-MM-YYYY", "lunarSighting": false, "month_en": "August", "month_number": 8, "weekday_en": "Sunday", "year": "2026", "year_number": 2026 }, "gregorian_date": "2026-08-23", "hijri": { "adjusted_holidays": [], "date": "10-03-1448", "day": "10", "day_number": 10, "days_in_month": 29, "described": "10 Rabi al-awwal 1448 AH", "format": "DD-MM-YYYY", "holidays": [], "is_holiday": false, "method": "HJCoSA", "month_ar": "\u0631\u0628\u064a\u0639 \u0627\u0644\u0623\u0648\u0644", "month_en": "Rabi al-awwal", "month_number": 3, "weekday_ar": "\u0627\u0644\u0627\u062d\u062f", "weekday_en": "Al Ahad", "year": "1448", "year_number": 1448 }, "hijri_date": "10-03-1448", "hijri_described": "10 Rabi al-awwal 1448 AH", "holidays": [], "is_holiday": false, "requested_date": "2026-08-23" } ``` ### Convert a Hijri date to the Gregorian calendar Turn a Hijri date into its Gregorian one. Pick the day, month and year separately so there is no date format to get right, and the Gregorian date comes back ready to drop into the date field of a later step. **Inputs** - Hijri day (`hijri_day`, number, required): The day of the Hijri month, from 1 to 30. A Hijri month never has thirty-one days. From 1 to 30. - Hijri month (`hijri_month`, text, required): The month of the Hijri calendar. One of: `1` (1. Muharram), `2` (2. Safar), `3` (3. Rabi al-awwal), `4` (4. Rabi al-thani), `5` (5. Jumada al-ula), `6` (6. Jumada al-akhirah), `7` (7. Rajab), `8` (8. Shaban), `9` (9. Ramadan), `10` (10. Shawwal), `11` (11. Dhu al-Qadah), `12` (12. Dhu al-Hijjah). - Hijri year (`hijri_year`, number, required): The Hijri year, from 1356 AH to 1500 AH, which is the range AlAdhan's calendars are tabulated for. Run 'Get the current Islamic date' if you need to know which year it is now. From 1356 to 1500. - Hijri calendar method (`calendar_method`, text): How a Gregorian date is turned into a Hijri one. Defaults to the High Judiciary Council of Saudi Arabia, which is what aladhan.com itself shows. Run 'List Hijri calendar methods' to see what each covers. One of: `HJCoSA` (High Judiciary Council of Saudi Arabia (default)), `UAQ` (Umm al-Qura), `DIYANET` (Diyanet Isleri Baskanligi, Turkey), `MATHEMATICAL` (Mathematical calculation). - Day adjustment (`adjustment`, number): Shift the converted Hijri date by whole days, from -5 to 5, for a local moon sighting that ran a day ahead or behind. AlAdhan applies it only under the Mathematical calendar method, so choose that method too. From -5 to 5. **Outputs** - `gregorian` (object) - `gregorian_date` (text) - `hijri` (object) - `hijri_date` (text) - `hijri_described` (text) - `holidays` (list) - `is_holiday` (true/false) - `requested_hijri_date` (text) - `requested_hijri_month_name` (text) **Example output** ```json { "gregorian": { "date": "23-08-2026", "date_iso": "2026-08-23", "day": "23", "day_number": 23, "format": "DD-MM-YYYY", "lunarSighting": false, "month_en": "August", "month_number": 8, "weekday_en": "Sunday", "year": "2026", "year_number": 2026 }, "gregorian_date": "2026-08-23", "hijri": { "adjusted_holidays": [], "date": "10-03-1448", "day": "10", "day_number": 10, "days_in_month": 29, "described": "10 Rabi al-awwal 1448 AH", "format": "DD-MM-YYYY", "holidays": [], "is_holiday": false, "method": "HJCoSA", "month_ar": "\u0631\u0628\u064a\u0639 \u0627\u0644\u0623\u0648\u0644", "month_en": "Rabi al-awwal", "month_number": 3, "weekday_ar": "\u0627\u0644\u0627\u062d\u062f", "weekday_en": "Al Ahad", "year": "1448", "year_number": 1448 }, "hijri_date": "10-03-1448", "hijri_described": "10 Rabi al-awwal 1448 AH", "holidays": [], "is_holiday": false, "requested_hijri_date": "10-03-1448", "requested_hijri_month_name": "Rabi al-awwal" } ``` ### Get a Hijri month or year of prayer times Get every day's prayer times for a Hijri month, or for a whole Hijri year when the month is left empty. This is the action that answers 'the timetable for the whole of Ramadan' in one step: choose Ramadan and the year, and each day comes back with both its Hijri and its Gregorian date. **Inputs** - Hijri year (`hijri_year`, number, required): The Hijri year, from 1356 AH to 1500 AH, which is the range AlAdhan's calendars are tabulated for. Run 'Get the current Islamic date' if you need to know which year it is now. From 1356 to 1500. - Hijri month (`hijri_month`, text): The month of the Hijri calendar. Leave empty for the whole year, which is around 355 days of prayer times in one step. One of: `1` (1. Muharram), `2` (2. Safar), `3` (3. Rabi al-awwal), `4` (4. Rabi al-thani), `5` (5. Jumada al-ula), `6` (6. Jumada al-akhirah), `7` (7. Rajab), `8` (8. Shaban), `9` (9. Ramadan), `10` (10. Shawwal), `11` (11. Dhu al-Qadah), `12` (12. Dhu al-Hijjah). - City (`city`, text): Fill in one of three ways to name the place: a city and its country, an address, or a latitude and longitude. The city, used together with the country below. - Country (`country`, text): The country the city is in. Required whenever a city is given. One of: `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua & Barbuda), `AR` (Argentina), `AM` (Armenia), and 239 more. - State or region (`state`, text): Optional, and only useful alongside a city: it tells apart the places that share a name, such as Springfield in Illinois and Springfield in Missouri. - Address (`address`, text): Fill in one of three ways to name the place: a city and its country, an address, or a latitude and longitude. A street address, a postcode or a place written as one line. Use it when you have an address rather than a city. - Latitude (`latitude`, number): Fill in one of three ways to name the place: a city and its country, an address, or a latitude and longitude. Latitude in decimal degrees, from -90 to 90. Coordinates are the exact way to name a place, and the only one that reports the position back unmasked. From -90 to 90. - Longitude (`longitude`, number): Longitude in decimal degrees, from -180 to 180. The Americas take a negative longitude. From -180 to 180. - Calculation method (`method`, text): Which authority's angles to compute the times with. Leave empty and AlAdhan uses the authority closest to the place, which is right far more often than a guess. Run 'List calculation methods' to see the angles each one sets. One of: `0` (Shia Ithna-Ashari, Leva Institute, Qum), `1` (University of Islamic Sciences, Karachi), `2` (Islamic Society of North America (ISNA)), `3` (Muslim World League), `4` (Umm Al-Qura University, Makkah), `5` (Egyptian General Authority of Survey), `7` (Institute of Geophysics, University of Tehran), `8` (Gulf Region), `9` (Kuwait), `10` (Qatar), and 13 more. - Asr calculation (`school`, text): Which juristic method places Asr. The Hanafi position puts it later in the afternoon than the other three schools. Defaults to the majority position. One of: `0` (Shafi, Maliki and Hanbali (the majority position)), `1` (Hanafi (Asr later in the afternoon)). - Midnight calculation (`midnight_mode`, text): Where midnight falls: halfway from sunset to sunrise, or halfway from sunset to Fajr. Defaults to the first. One of: `0` (Standard: halfway from sunset to sunrise), `1` (Jafari: halfway from sunset to Fajr). - High latitude rule (`high_latitude_rule`, text): What to do where the sun never drops far enough below the horizon for Fajr and Isha to have a true time, which is most of northern Europe in summer. Only worth setting above roughly 48 degrees of latitude. One of: `1` (Middle of the night), `2` (One seventh of the night), `3` (Angle based). - Shafaq (`shafaq`, text): Which twilight places Isha. Applies only to the Moonsighting Committee Worldwide method, and is ignored with any other, so it is sent only when that method is chosen. One of: `general`, `ahmer` (Ahmer: the red twilight), `abyad` (Abyad: the white twilight). - Timezone (`timezone`, text): The timezone to report the times in. Leave empty and AlAdhan works it out from the place, which is almost always what you want. It also decides what 'today' means when the date is left blank. One of: `UTC`, `Africa/Abidjan`, `Africa/Accra`, `Africa/Addis_Ababa` (Africa/Addis Ababa), `Africa/Algiers`, `Africa/Asmara`, `Africa/Bamako`, `Africa/Bangui`, `Africa/Banjul`, `Africa/Bissau`, and 439 more. - Hijri calendar method (`calendar_method`, text): How a Gregorian date is turned into a Hijri one. Defaults to the High Judiciary Council of Saudi Arabia, which is what aladhan.com itself shows. Run 'List Hijri calendar methods' to see what each covers. One of: `HJCoSA` (High Judiciary Council of Saudi Arabia (default)), `UAQ` (Umm al-Qura), `DIYANET` (Diyanet Isleri Baskanligi, Turkey), `MATHEMATICAL` (Mathematical calculation). - Adjust Imsak (`tune_imsak`, number): Minutes to shift Imsak by, from -120 to 120. Imsak is the end of the pre-dawn meal. Leave empty for no adjustment. From -120 to 120. - Adjust Fajr (`tune_fajr`, number): Minutes to shift Fajr by, from -120 to 120. A local mosque commonly runs a minute or two later. Leave empty for no adjustment. From -120 to 120. - Adjust Sunrise (`tune_sunrise`, number): Minutes to shift Sunrise by, from -120 to 120. Sunrise ends the time for Fajr. Leave empty for no adjustment. From -120 to 120. - Adjust Dhuhr (`tune_dhuhr`, number): Minutes to shift Dhuhr by, from -120 to 120. Dhuhr is the midday prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Asr (`tune_asr`, number): Minutes to shift Asr by, from -120 to 120. Asr is the afternoon prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Maghrib (`tune_maghrib`, number): Minutes to shift Maghrib by, from -120 to 120. Maghrib is the sunset prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Sunset (`tune_sunset`, number): Minutes to shift Sunset by, from -120 to 120. Sunset is the marker Maghrib is measured from. Leave empty for no adjustment. From -120 to 120. - Adjust Isha (`tune_isha`, number): Minutes to shift Isha by, from -120 to 120. Isha is the night prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Midnight (`tune_midnight`, number): Minutes to shift Midnight by, from -120 to 120. Midnight marks the last third of the night. Leave empty for no adjustment. From -120 to 120. **Outputs** - `calendar` (text) - `day_count` (number) - `days` (list) - `first_date` (text) - `hijri_month` (number) - `hijri_month_name` (text) - `hijri_year` (number) - `last_date` (text) - `location` (object) - `months` (list) - `settings` (object) **Example output** ```json { "calendar": "hijri", "day_count": 29, "days": [ { "date": { "date": "2026-08-23", "gregorian": { "date": "23-08-2026", "date_iso": "2026-08-23", "day": "23", "day_number": 23, "format": "DD-MM-YYYY", "lunarSighting": false, "month_en": "August", "month_number": 8, "weekday_en": "Sunday", "year": "2026", "year_number": 2026 }, "hijri": { "adjusted_holidays": [], "date": "10-03-1448", "day": "10", "day_number": 10, "days_in_month": 29, "described": "10 Rabi al-awwal 1448 AH", "format": "DD-MM-YYYY", "holidays": [], "is_holiday": false, "method": "HJCoSA", "month_ar": "\u0631\u0628\u064a\u0639 \u0627\u0644\u0623\u0648\u0644", "month_en": "Rabi al-awwal", "month_number": 3, "weekday_ar": "\u0627\u0644\u0627\u062d\u062f", "weekday_en": "Al Ahad", "year": "1448", "year_number": 1448 }, "hijri_date": "10 Rabi al-awwal 1448 AH", "holidays": [], "readable": "23 Aug 2026", "timestamp": 1787464800 }, "meta": { "coordinates_masked": false, "latitude": 51.50853, "latitudeAdjustmentMethod": "ANGLE_BASED", "longitude": -0.12574, "method_id": 2, "method_name": "Islamic Society of North America (ISNA)", "midnightMode": "STANDARD", "offsets": {}, "school": "STANDARD", "timezone": "Europe/London" }, "prayer_times": [ { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T04:12:00+01:00", "name": "Fajr", "time": "04:12" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T13:03:00+01:00", "name": "Dhuhr", "time": "13:03" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T16:56:00+01:00", "name": "Asr", "time": "16:56" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T20:07:00+01:00", "name": "Maghrib", "time": "20:07" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T21:53:00+01:00", "name": "Isha", "time": "21:53" } ], "prayers": [ { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T04:12:00+01:00", "name": "Fajr", "time": "04:12" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T13:03:00+01:00", "name": "Dhuhr", "time": "13:03" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T16:56:00+01:00", "name": "Asr", "time": "16:56" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T20:07:00+01:00", "name": "Maghrib", "time": "20:07" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T21:53:00+01:00", "name": "Isha", "time": "21:53" } ], "timings": { "Asr": "16:56", "Dhuhr": "13:03", "Fajr": "04:12", "Firstthird": "23:24", "Imsak": "04:02", "Isha": "21:53", "Lastthird": "02:41", "Maghrib": "20:07", "Midnight": "01:03", "Sunrise": "05:59", "Sunset": "20:07" } } ], "first_date": "2027-02-08", "hijri_month": 9, "hijri_month_name": "Ramadan", "hijri_year": 1448, "last_date": "2027-03-08", "location": { "city": "London", "country": "GB", "described": "London, GB", "kind": "city" }, "months": [ { "day_count": 29, "first_date": "2027-02-08", "last_date": "2027-03-08", "month": 9, "month_name": "Ramadan" } ], "settings": { "calendar_method": null, "high_latitude_rule": null, "method": 2, "method_name": "Islamic Society of North America (ISNA)", "midnight_mode": null, "school": null, "shafaq": null, "timezone": null, "tune": null } } ``` ### Get a month or year of prayer times Get every day's prayer times for a Gregorian month, or for a whole year when the month is left empty. Use it to publish a timetable rather than a single day. The answer is one list of days in date order whichever was asked for, with a per-month breakdown beside it. **Inputs** - Year (`year`, number): The Gregorian year. Leave empty for the current year. From 1000 to 9999. - Month (`month`, text): The Gregorian month. Leave empty for the whole year, which is 365 days of prayer times in one step. One of: `1` (January), `2` (February), `3` (March), `4` (April), `5` (May), `6` (June), `7` (July), `8` (August), `9` (September), `10` (October), `11` (November), `12` (December). - City (`city`, text): Fill in one of three ways to name the place: a city and its country, an address, or a latitude and longitude. The city, used together with the country below. - Country (`country`, text): The country the city is in. Required whenever a city is given. One of: `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua & Barbuda), `AR` (Argentina), `AM` (Armenia), and 239 more. - State or region (`state`, text): Optional, and only useful alongside a city: it tells apart the places that share a name, such as Springfield in Illinois and Springfield in Missouri. - Address (`address`, text): Fill in one of three ways to name the place: a city and its country, an address, or a latitude and longitude. A street address, a postcode or a place written as one line. Use it when you have an address rather than a city. - Latitude (`latitude`, number): Fill in one of three ways to name the place: a city and its country, an address, or a latitude and longitude. Latitude in decimal degrees, from -90 to 90. Coordinates are the exact way to name a place, and the only one that reports the position back unmasked. From -90 to 90. - Longitude (`longitude`, number): Longitude in decimal degrees, from -180 to 180. The Americas take a negative longitude. From -180 to 180. - Calculation method (`method`, text): Which authority's angles to compute the times with. Leave empty and AlAdhan uses the authority closest to the place, which is right far more often than a guess. Run 'List calculation methods' to see the angles each one sets. One of: `0` (Shia Ithna-Ashari, Leva Institute, Qum), `1` (University of Islamic Sciences, Karachi), `2` (Islamic Society of North America (ISNA)), `3` (Muslim World League), `4` (Umm Al-Qura University, Makkah), `5` (Egyptian General Authority of Survey), `7` (Institute of Geophysics, University of Tehran), `8` (Gulf Region), `9` (Kuwait), `10` (Qatar), and 13 more. - Asr calculation (`school`, text): Which juristic method places Asr. The Hanafi position puts it later in the afternoon than the other three schools. Defaults to the majority position. One of: `0` (Shafi, Maliki and Hanbali (the majority position)), `1` (Hanafi (Asr later in the afternoon)). - Midnight calculation (`midnight_mode`, text): Where midnight falls: halfway from sunset to sunrise, or halfway from sunset to Fajr. Defaults to the first. One of: `0` (Standard: halfway from sunset to sunrise), `1` (Jafari: halfway from sunset to Fajr). - High latitude rule (`high_latitude_rule`, text): What to do where the sun never drops far enough below the horizon for Fajr and Isha to have a true time, which is most of northern Europe in summer. Only worth setting above roughly 48 degrees of latitude. One of: `1` (Middle of the night), `2` (One seventh of the night), `3` (Angle based). - Shafaq (`shafaq`, text): Which twilight places Isha. Applies only to the Moonsighting Committee Worldwide method, and is ignored with any other, so it is sent only when that method is chosen. One of: `general`, `ahmer` (Ahmer: the red twilight), `abyad` (Abyad: the white twilight). - Timezone (`timezone`, text): The timezone to report the times in. Leave empty and AlAdhan works it out from the place, which is almost always what you want. It also decides what 'today' means when the date is left blank. One of: `UTC`, `Africa/Abidjan`, `Africa/Accra`, `Africa/Addis_Ababa` (Africa/Addis Ababa), `Africa/Algiers`, `Africa/Asmara`, `Africa/Bamako`, `Africa/Bangui`, `Africa/Banjul`, `Africa/Bissau`, and 439 more. - Hijri calendar method (`calendar_method`, text): How a Gregorian date is turned into a Hijri one. Defaults to the High Judiciary Council of Saudi Arabia, which is what aladhan.com itself shows. Run 'List Hijri calendar methods' to see what each covers. One of: `HJCoSA` (High Judiciary Council of Saudi Arabia (default)), `UAQ` (Umm al-Qura), `DIYANET` (Diyanet Isleri Baskanligi, Turkey), `MATHEMATICAL` (Mathematical calculation). - Adjust Imsak (`tune_imsak`, number): Minutes to shift Imsak by, from -120 to 120. Imsak is the end of the pre-dawn meal. Leave empty for no adjustment. From -120 to 120. - Adjust Fajr (`tune_fajr`, number): Minutes to shift Fajr by, from -120 to 120. A local mosque commonly runs a minute or two later. Leave empty for no adjustment. From -120 to 120. - Adjust Sunrise (`tune_sunrise`, number): Minutes to shift Sunrise by, from -120 to 120. Sunrise ends the time for Fajr. Leave empty for no adjustment. From -120 to 120. - Adjust Dhuhr (`tune_dhuhr`, number): Minutes to shift Dhuhr by, from -120 to 120. Dhuhr is the midday prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Asr (`tune_asr`, number): Minutes to shift Asr by, from -120 to 120. Asr is the afternoon prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Maghrib (`tune_maghrib`, number): Minutes to shift Maghrib by, from -120 to 120. Maghrib is the sunset prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Sunset (`tune_sunset`, number): Minutes to shift Sunset by, from -120 to 120. Sunset is the marker Maghrib is measured from. Leave empty for no adjustment. From -120 to 120. - Adjust Isha (`tune_isha`, number): Minutes to shift Isha by, from -120 to 120. Isha is the night prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Midnight (`tune_midnight`, number): Minutes to shift Midnight by, from -120 to 120. Midnight marks the last third of the night. Leave empty for no adjustment. From -120 to 120. **Outputs** - `calendar` (text) - `day_count` (number) - `days` (list) - `first_date` (text) - `last_date` (text) - `location` (object) - `month` (number) - `months` (list) - `settings` (object) - `year` (number) **Example output** ```json { "calendar": "gregorian", "day_count": 30, "days": [ { "date": { "date": "2026-08-23", "gregorian": { "date": "23-08-2026", "date_iso": "2026-08-23", "day": "23", "day_number": 23, "format": "DD-MM-YYYY", "lunarSighting": false, "month_en": "August", "month_number": 8, "weekday_en": "Sunday", "year": "2026", "year_number": 2026 }, "hijri": { "adjusted_holidays": [], "date": "10-03-1448", "day": "10", "day_number": 10, "days_in_month": 29, "described": "10 Rabi al-awwal 1448 AH", "format": "DD-MM-YYYY", "holidays": [], "is_holiday": false, "method": "HJCoSA", "month_ar": "\u0631\u0628\u064a\u0639 \u0627\u0644\u0623\u0648\u0644", "month_en": "Rabi al-awwal", "month_number": 3, "weekday_ar": "\u0627\u0644\u0627\u062d\u062f", "weekday_en": "Al Ahad", "year": "1448", "year_number": 1448 }, "hijri_date": "10 Rabi al-awwal 1448 AH", "holidays": [], "readable": "23 Aug 2026", "timestamp": 1787464800 }, "meta": { "coordinates_masked": false, "latitude": 51.50853, "latitudeAdjustmentMethod": "ANGLE_BASED", "longitude": -0.12574, "method_id": 2, "method_name": "Islamic Society of North America (ISNA)", "midnightMode": "STANDARD", "offsets": {}, "school": "STANDARD", "timezone": "Europe/London" }, "prayer_times": [ { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T04:12:00+01:00", "name": "Fajr", "time": "04:12" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T13:03:00+01:00", "name": "Dhuhr", "time": "13:03" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T16:56:00+01:00", "name": "Asr", "time": "16:56" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T20:07:00+01:00", "name": "Maghrib", "time": "20:07" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T21:53:00+01:00", "name": "Isha", "time": "21:53" } ], "prayers": [ { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T04:12:00+01:00", "name": "Fajr", "time": "04:12" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T13:03:00+01:00", "name": "Dhuhr", "time": "13:03" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T16:56:00+01:00", "name": "Asr", "time": "16:56" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T20:07:00+01:00", "name": "Maghrib", "time": "20:07" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T21:53:00+01:00", "name": "Isha", "time": "21:53" } ], "timings": { "Asr": "16:56", "Dhuhr": "13:03", "Fajr": "04:12", "Firstthird": "23:24", "Imsak": "04:02", "Isha": "21:53", "Lastthird": "02:41", "Maghrib": "20:07", "Midnight": "01:03", "Sunrise": "05:59", "Sunset": "20:07" } } ], "first_date": "2026-09-01", "last_date": "2026-09-30", "location": { "city": "London", "country": "GB", "described": "London, GB", "kind": "city" }, "month": 9, "months": [ { "day_count": 30, "first_date": "2026-09-01", "last_date": "2026-09-30", "month": 9, "month_name": null } ], "settings": { "calendar_method": null, "high_latitude_rule": null, "method": 2, "method_name": "Islamic Society of North America (ISNA)", "midnight_mode": null, "school": null, "shafaq": null, "timezone": null, "tune": null }, "year": 2026 } ``` ### Get a Qibla compass image Get a compass picture marking the Qibla from a set of coordinates, as an image address to put in a message or a page. The picture is checked and described rather than downloaded, so the step returns a link rather than a hundred and fifty kilobytes of image. **Inputs** - Latitude (`latitude`, number, required): Latitude in decimal degrees, from -90 to 90. From -90 to 90. - Longitude (`longitude`, number, required): Longitude in decimal degrees, from -180 to 180. The Americas take a negative longitude. From -180 to 180. **Outputs** - `content_type` (text) - `image_url` (text) - `latitude` (number) - `longitude` (number) - `size_bytes` (number) **Example output** ```json { "content_type": "image/png", "image_url": "https://api.aladhan.com/v1/qibla/51.50853/-0.12574/compass", "latitude": 51.50853, "longitude": -0.12574, "size_bytes": 150856 } ``` ### Get names of Allah by number Get one or more of the ninety-nine names by number, chosen from the list. Use it to post a particular name, or a few, rather than pulling all ninety-nine and filtering afterwards. **Inputs** - Names (`numbers`, list, required): Which of the ninety-nine names to fetch. Choose one or several. One or more of: `1` (1. Ar Rahmaan (The Beneficent)), `2` (2. Ar Raheem (The Merciful)), `3` (3. Al Malik (The King / Eternal Lord)), `4` (4. Al Quddus (The Purest)), `5` (5. As Salaam (The Source of Peace)), `6` (6. Al Mu'min (The inspirer of faith)), `7` (7. Al Muhaymin (The Guardian)), `8` (8. Al Azeez (The Precious / The Most Mighty)), `9` (9. Al Jabbaar (The Compeller)), `10` (10. Al Mutakabbir (The Greatest)), and 89 more. **Outputs** - `count` (number) - `names` (list) - `requested_count` (number) - `requested_numbers` (list) **Example output** ```json { "count": 2, "names": [ { "arabic": "\u0627\u0644\u0631\u062d\u0645\u0646", "meaning": "The Beneficent", "name": "\u0627\u0644\u0631\u062d\u0645\u0646", "number": 1, "transliteration": "Ar Rahmaan" }, { "arabic": "\u0627\u0644\u0631\u062d\u064a\u0645", "meaning": "The Merciful", "name": "\u0627\u0644\u0631\u062d\u064a\u0645", "number": 2, "transliteration": "Ar Raheem" } ], "requested_count": 2, "requested_numbers": [ 1, 2 ] } ``` ### Get prayer times Get the day's prayer times for a place: Fajr, Dhuhr, Asr, Maghrib and Isha, alongside Imsak, sunrise, sunset and the thirds of the night. Name the place by city and country, by address, or by coordinates. Every time comes back both as a clock time and as a full timestamp with its offset, so a reminder can be scheduled straight off it, and the day's Hijri date and any holiday come with it. Leave the date empty for today. **Inputs** - Date (`date`, date): The day to get times for. Leave empty for today in the place you asked about. - City (`city`, text): Fill in one of three ways to name the place: a city and its country, an address, or a latitude and longitude. The city, used together with the country below. - Country (`country`, text): The country the city is in. Required whenever a city is given. One of: `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua & Barbuda), `AR` (Argentina), `AM` (Armenia), and 239 more. - State or region (`state`, text): Optional, and only useful alongside a city: it tells apart the places that share a name, such as Springfield in Illinois and Springfield in Missouri. - Address (`address`, text): Fill in one of three ways to name the place: a city and its country, an address, or a latitude and longitude. A street address, a postcode or a place written as one line. Use it when you have an address rather than a city. - Latitude (`latitude`, number): Fill in one of three ways to name the place: a city and its country, an address, or a latitude and longitude. Latitude in decimal degrees, from -90 to 90. Coordinates are the exact way to name a place, and the only one that reports the position back unmasked. From -90 to 90. - Longitude (`longitude`, number): Longitude in decimal degrees, from -180 to 180. The Americas take a negative longitude. From -180 to 180. - Calculation method (`method`, text): Which authority's angles to compute the times with. Leave empty and AlAdhan uses the authority closest to the place, which is right far more often than a guess. Run 'List calculation methods' to see the angles each one sets. One of: `0` (Shia Ithna-Ashari, Leva Institute, Qum), `1` (University of Islamic Sciences, Karachi), `2` (Islamic Society of North America (ISNA)), `3` (Muslim World League), `4` (Umm Al-Qura University, Makkah), `5` (Egyptian General Authority of Survey), `7` (Institute of Geophysics, University of Tehran), `8` (Gulf Region), `9` (Kuwait), `10` (Qatar), and 13 more. - Asr calculation (`school`, text): Which juristic method places Asr. The Hanafi position puts it later in the afternoon than the other three schools. Defaults to the majority position. One of: `0` (Shafi, Maliki and Hanbali (the majority position)), `1` (Hanafi (Asr later in the afternoon)). - Midnight calculation (`midnight_mode`, text): Where midnight falls: halfway from sunset to sunrise, or halfway from sunset to Fajr. Defaults to the first. One of: `0` (Standard: halfway from sunset to sunrise), `1` (Jafari: halfway from sunset to Fajr). - High latitude rule (`high_latitude_rule`, text): What to do where the sun never drops far enough below the horizon for Fajr and Isha to have a true time, which is most of northern Europe in summer. Only worth setting above roughly 48 degrees of latitude. One of: `1` (Middle of the night), `2` (One seventh of the night), `3` (Angle based). - Shafaq (`shafaq`, text): Which twilight places Isha. Applies only to the Moonsighting Committee Worldwide method, and is ignored with any other, so it is sent only when that method is chosen. One of: `general`, `ahmer` (Ahmer: the red twilight), `abyad` (Abyad: the white twilight). - Timezone (`timezone`, text): The timezone to report the times in. Leave empty and AlAdhan works it out from the place, which is almost always what you want. It also decides what 'today' means when the date is left blank. One of: `UTC`, `Africa/Abidjan`, `Africa/Accra`, `Africa/Addis_Ababa` (Africa/Addis Ababa), `Africa/Algiers`, `Africa/Asmara`, `Africa/Bamako`, `Africa/Bangui`, `Africa/Banjul`, `Africa/Bissau`, and 439 more. - Hijri calendar method (`calendar_method`, text): How a Gregorian date is turned into a Hijri one. Defaults to the High Judiciary Council of Saudi Arabia, which is what aladhan.com itself shows. Run 'List Hijri calendar methods' to see what each covers. One of: `HJCoSA` (High Judiciary Council of Saudi Arabia (default)), `UAQ` (Umm al-Qura), `DIYANET` (Diyanet Isleri Baskanligi, Turkey), `MATHEMATICAL` (Mathematical calculation). - Adjust Imsak (`tune_imsak`, number): Minutes to shift Imsak by, from -120 to 120. Imsak is the end of the pre-dawn meal. Leave empty for no adjustment. From -120 to 120. - Adjust Fajr (`tune_fajr`, number): Minutes to shift Fajr by, from -120 to 120. A local mosque commonly runs a minute or two later. Leave empty for no adjustment. From -120 to 120. - Adjust Sunrise (`tune_sunrise`, number): Minutes to shift Sunrise by, from -120 to 120. Sunrise ends the time for Fajr. Leave empty for no adjustment. From -120 to 120. - Adjust Dhuhr (`tune_dhuhr`, number): Minutes to shift Dhuhr by, from -120 to 120. Dhuhr is the midday prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Asr (`tune_asr`, number): Minutes to shift Asr by, from -120 to 120. Asr is the afternoon prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Maghrib (`tune_maghrib`, number): Minutes to shift Maghrib by, from -120 to 120. Maghrib is the sunset prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Sunset (`tune_sunset`, number): Minutes to shift Sunset by, from -120 to 120. Sunset is the marker Maghrib is measured from. Leave empty for no adjustment. From -120 to 120. - Adjust Isha (`tune_isha`, number): Minutes to shift Isha by, from -120 to 120. Isha is the night prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Midnight (`tune_midnight`, number): Minutes to shift Midnight by, from -120 to 120. Midnight marks the last third of the night. Leave empty for no adjustment. From -120 to 120. **Outputs** - `date` (object) - `location` (object) - `meta` (object) - `prayer_times` (list) - `prayers` (list) - `requested_date` (text) - `settings` (object) - `timings` (object) - `timings_iso8601` (object) **Example output** ```json { "date": { "date": "2026-08-23", "gregorian": { "date": "23-08-2026", "date_iso": "2026-08-23", "day": "23", "day_number": 23, "format": "DD-MM-YYYY", "lunarSighting": false, "month_en": "August", "month_number": 8, "weekday_en": "Sunday", "year": "2026", "year_number": 2026 }, "hijri": { "adjusted_holidays": [], "date": "10-03-1448", "day": "10", "day_number": 10, "days_in_month": 29, "described": "10 Rabi al-awwal 1448 AH", "format": "DD-MM-YYYY", "holidays": [], "is_holiday": false, "method": "HJCoSA", "month_ar": "\u0631\u0628\u064a\u0639 \u0627\u0644\u0623\u0648\u0644", "month_en": "Rabi al-awwal", "month_number": 3, "weekday_ar": "\u0627\u0644\u0627\u062d\u062f", "weekday_en": "Al Ahad", "year": "1448", "year_number": 1448 }, "hijri_date": "10 Rabi al-awwal 1448 AH", "holidays": [], "readable": "23 Aug 2026", "timestamp": 1787464800 }, "location": { "city": "London", "country": "GB", "described": "London, GB", "kind": "city" }, "meta": { "coordinates_masked": false, "latitude": 51.50853, "latitudeAdjustmentMethod": "ANGLE_BASED", "longitude": -0.12574, "method_id": 2, "method_name": "Islamic Society of North America (ISNA)", "midnightMode": "STANDARD", "offsets": {}, "school": "STANDARD", "timezone": "Europe/London" }, "prayer_times": [ { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T04:12:00+01:00", "name": "Fajr", "time": "04:12" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T13:03:00+01:00", "name": "Dhuhr", "time": "13:03" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T16:56:00+01:00", "name": "Asr", "time": "16:56" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T20:07:00+01:00", "name": "Maghrib", "time": "20:07" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T21:53:00+01:00", "name": "Isha", "time": "21:53" } ], "prayers": [ { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T04:12:00+01:00", "name": "Fajr", "time": "04:12" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T13:03:00+01:00", "name": "Dhuhr", "time": "13:03" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T16:56:00+01:00", "name": "Asr", "time": "16:56" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T20:07:00+01:00", "name": "Maghrib", "time": "20:07" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T21:53:00+01:00", "name": "Isha", "time": "21:53" } ], "requested_date": "2026-08-23", "settings": { "calendar_method": null, "high_latitude_rule": null, "method": 2, "method_name": "Islamic Society of North America (ISNA)", "midnight_mode": null, "school": null, "shafaq": null, "timezone": null, "tune": null }, "timings": { "Asr": "16:56", "Dhuhr": "13:03", "Fajr": "04:12", "Firstthird": "23:24", "Imsak": "04:02", "Isha": "21:53", "Lastthird": "02:41", "Maghrib": "20:07", "Midnight": "01:03", "Sunrise": "05:59", "Sunset": "20:07" } } ``` ### Get prayer times between two dates Get every day's prayer times between two dates, for a span that doesn't line up with a calendar month: a trip, a term, or the week ahead. AlAdhan returns at most eleven months in one call, and a longer range is refused with the limit named. **Inputs** - Start date (`date_start`, date, required): First day of the range. - End date (`date_end`, date, required): Last day of the range, at most eleven months after the start date. - City (`city`, text): Fill in one of three ways to name the place: a city and its country, an address, or a latitude and longitude. The city, used together with the country below. - Country (`country`, text): The country the city is in. Required whenever a city is given. One of: `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua & Barbuda), `AR` (Argentina), `AM` (Armenia), and 239 more. - State or region (`state`, text): Optional, and only useful alongside a city: it tells apart the places that share a name, such as Springfield in Illinois and Springfield in Missouri. - Address (`address`, text): Fill in one of three ways to name the place: a city and its country, an address, or a latitude and longitude. A street address, a postcode or a place written as one line. Use it when you have an address rather than a city. - Latitude (`latitude`, number): Fill in one of three ways to name the place: a city and its country, an address, or a latitude and longitude. Latitude in decimal degrees, from -90 to 90. Coordinates are the exact way to name a place, and the only one that reports the position back unmasked. From -90 to 90. - Longitude (`longitude`, number): Longitude in decimal degrees, from -180 to 180. The Americas take a negative longitude. From -180 to 180. - Calculation method (`method`, text): Which authority's angles to compute the times with. Leave empty and AlAdhan uses the authority closest to the place, which is right far more often than a guess. Run 'List calculation methods' to see the angles each one sets. One of: `0` (Shia Ithna-Ashari, Leva Institute, Qum), `1` (University of Islamic Sciences, Karachi), `2` (Islamic Society of North America (ISNA)), `3` (Muslim World League), `4` (Umm Al-Qura University, Makkah), `5` (Egyptian General Authority of Survey), `7` (Institute of Geophysics, University of Tehran), `8` (Gulf Region), `9` (Kuwait), `10` (Qatar), and 13 more. - Asr calculation (`school`, text): Which juristic method places Asr. The Hanafi position puts it later in the afternoon than the other three schools. Defaults to the majority position. One of: `0` (Shafi, Maliki and Hanbali (the majority position)), `1` (Hanafi (Asr later in the afternoon)). - Midnight calculation (`midnight_mode`, text): Where midnight falls: halfway from sunset to sunrise, or halfway from sunset to Fajr. Defaults to the first. One of: `0` (Standard: halfway from sunset to sunrise), `1` (Jafari: halfway from sunset to Fajr). - High latitude rule (`high_latitude_rule`, text): What to do where the sun never drops far enough below the horizon for Fajr and Isha to have a true time, which is most of northern Europe in summer. Only worth setting above roughly 48 degrees of latitude. One of: `1` (Middle of the night), `2` (One seventh of the night), `3` (Angle based). - Shafaq (`shafaq`, text): Which twilight places Isha. Applies only to the Moonsighting Committee Worldwide method, and is ignored with any other, so it is sent only when that method is chosen. One of: `general`, `ahmer` (Ahmer: the red twilight), `abyad` (Abyad: the white twilight). - Timezone (`timezone`, text): The timezone to report the times in. Leave empty and AlAdhan works it out from the place, which is almost always what you want. It also decides what 'today' means when the date is left blank. One of: `UTC`, `Africa/Abidjan`, `Africa/Accra`, `Africa/Addis_Ababa` (Africa/Addis Ababa), `Africa/Algiers`, `Africa/Asmara`, `Africa/Bamako`, `Africa/Bangui`, `Africa/Banjul`, `Africa/Bissau`, and 439 more. - Hijri calendar method (`calendar_method`, text): How a Gregorian date is turned into a Hijri one. Defaults to the High Judiciary Council of Saudi Arabia, which is what aladhan.com itself shows. Run 'List Hijri calendar methods' to see what each covers. One of: `HJCoSA` (High Judiciary Council of Saudi Arabia (default)), `UAQ` (Umm al-Qura), `DIYANET` (Diyanet Isleri Baskanligi, Turkey), `MATHEMATICAL` (Mathematical calculation). - Adjust Imsak (`tune_imsak`, number): Minutes to shift Imsak by, from -120 to 120. Imsak is the end of the pre-dawn meal. Leave empty for no adjustment. From -120 to 120. - Adjust Fajr (`tune_fajr`, number): Minutes to shift Fajr by, from -120 to 120. A local mosque commonly runs a minute or two later. Leave empty for no adjustment. From -120 to 120. - Adjust Sunrise (`tune_sunrise`, number): Minutes to shift Sunrise by, from -120 to 120. Sunrise ends the time for Fajr. Leave empty for no adjustment. From -120 to 120. - Adjust Dhuhr (`tune_dhuhr`, number): Minutes to shift Dhuhr by, from -120 to 120. Dhuhr is the midday prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Asr (`tune_asr`, number): Minutes to shift Asr by, from -120 to 120. Asr is the afternoon prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Maghrib (`tune_maghrib`, number): Minutes to shift Maghrib by, from -120 to 120. Maghrib is the sunset prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Sunset (`tune_sunset`, number): Minutes to shift Sunset by, from -120 to 120. Sunset is the marker Maghrib is measured from. Leave empty for no adjustment. From -120 to 120. - Adjust Isha (`tune_isha`, number): Minutes to shift Isha by, from -120 to 120. Isha is the night prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Midnight (`tune_midnight`, number): Minutes to shift Midnight by, from -120 to 120. Midnight marks the last third of the night. Leave empty for no adjustment. From -120 to 120. **Outputs** - `calendar` (text) - `date_end` (text) - `date_start` (text) - `day_count` (number) - `days` (list) - `first_date` (text) - `last_date` (text) - `location` (object) - `months` (list) - `settings` (object) **Example output** ```json { "calendar": "gregorian", "date_end": "2026-08-26", "date_start": "2026-08-23", "day_count": 4, "days": [ { "date": { "date": "2026-08-23", "gregorian": { "date": "23-08-2026", "date_iso": "2026-08-23", "day": "23", "day_number": 23, "format": "DD-MM-YYYY", "lunarSighting": false, "month_en": "August", "month_number": 8, "weekday_en": "Sunday", "year": "2026", "year_number": 2026 }, "hijri": { "adjusted_holidays": [], "date": "10-03-1448", "day": "10", "day_number": 10, "days_in_month": 29, "described": "10 Rabi al-awwal 1448 AH", "format": "DD-MM-YYYY", "holidays": [], "is_holiday": false, "method": "HJCoSA", "month_ar": "\u0631\u0628\u064a\u0639 \u0627\u0644\u0623\u0648\u0644", "month_en": "Rabi al-awwal", "month_number": 3, "weekday_ar": "\u0627\u0644\u0627\u062d\u062f", "weekday_en": "Al Ahad", "year": "1448", "year_number": 1448 }, "hijri_date": "10 Rabi al-awwal 1448 AH", "holidays": [], "readable": "23 Aug 2026", "timestamp": 1787464800 }, "meta": { "coordinates_masked": false, "latitude": 51.50853, "latitudeAdjustmentMethod": "ANGLE_BASED", "longitude": -0.12574, "method_id": 2, "method_name": "Islamic Society of North America (ISNA)", "midnightMode": "STANDARD", "offsets": {}, "school": "STANDARD", "timezone": "Europe/London" }, "prayer_times": [ { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T04:12:00+01:00", "name": "Fajr", "time": "04:12" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T13:03:00+01:00", "name": "Dhuhr", "time": "13:03" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T16:56:00+01:00", "name": "Asr", "time": "16:56" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T20:07:00+01:00", "name": "Maghrib", "time": "20:07" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T21:53:00+01:00", "name": "Isha", "time": "21:53" } ], "prayers": [ { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T04:12:00+01:00", "name": "Fajr", "time": "04:12" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T13:03:00+01:00", "name": "Dhuhr", "time": "13:03" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T16:56:00+01:00", "name": "Asr", "time": "16:56" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T20:07:00+01:00", "name": "Maghrib", "time": "20:07" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T21:53:00+01:00", "name": "Isha", "time": "21:53" } ], "timings": { "Asr": "16:56", "Dhuhr": "13:03", "Fajr": "04:12", "Firstthird": "23:24", "Imsak": "04:02", "Isha": "21:53", "Lastthird": "02:41", "Maghrib": "20:07", "Midnight": "01:03", "Sunrise": "05:59", "Sunset": "20:07" } } ], "first_date": "2026-08-23", "last_date": "2026-08-26", "location": { "city": "London", "country": "GB", "described": "London, GB", "kind": "city" }, "months": [ { "day_count": 4, "first_date": "2026-08-23", "last_date": "2026-08-26", "month": 8, "month_name": null } ], "settings": { "calendar_method": null, "high_latitude_rule": null, "method": 2, "method_name": "Islamic Society of North America (ISNA)", "midnight_mode": null, "school": null, "shafaq": null, "timezone": null, "tune": null } } ``` ### Get the current Islamic date Get the Hijri month and year it is now, in English and Arabic. Use it to fill in the year for the Hijri calendar actions without hard-coding one that goes stale. **Inputs**: None. **Outputs** - `described` (text) - `month` (number) - `month_ar` (text) - `month_en` (text) - `requests_made` (number) - `year` (number) **Example output** ```json { "described": "Rabi al-awwal 1448 AH", "month": 3, "month_ar": "\u0631\u0628\u064a\u0639 \u0627\u0644\u0623\u0648\u0644", "month_en": "Rabi al-awwal", "requests_made": 2, "year": 1448 } ``` ### Get the Gregorian dates for a Hijri month Get every day of a Hijri month with its Gregorian date and any holidays on it. This is how to find out which Gregorian dates Ramadan or Dhu al-Hijjah fall on in a given year. **Inputs** - Hijri month (`hijri_month`, text, required): The month of the Hijri calendar. One of: `1` (1. Muharram), `2` (2. Safar), `3` (3. Rabi al-awwal), `4` (4. Rabi al-thani), `5` (5. Jumada al-ula), `6` (6. Jumada al-akhirah), `7` (7. Rajab), `8` (8. Shaban), `9` (9. Ramadan), `10` (10. Shawwal), `11` (11. Dhu al-Qadah), `12` (12. Dhu al-Hijjah). - Hijri year (`hijri_year`, number, required): The Hijri year, from 1356 AH to 1500 AH, which is the range AlAdhan's calendars are tabulated for. Run 'Get the current Islamic date' if you need to know which year it is now. From 1356 to 1500. - Hijri calendar method (`calendar_method`, text): How a Gregorian date is turned into a Hijri one. Defaults to the High Judiciary Council of Saudi Arabia, which is what aladhan.com itself shows. Run 'List Hijri calendar methods' to see what each covers. One of: `HJCoSA` (High Judiciary Council of Saudi Arabia (default)), `UAQ` (Umm al-Qura), `DIYANET` (Diyanet Isleri Baskanligi, Turkey), `MATHEMATICAL` (Mathematical calculation). - Day adjustment (`adjustment`, number): Shift the converted Hijri date by whole days, from -5 to 5, for a local moon sighting that ran a day ahead or behind. AlAdhan applies it only under the Mathematical calendar method, so choose that method too. From -5 to 5. **Outputs** - `calendar` (text) - `day_count` (number) - `days` (list) - `first_date` (text) - `hijri_month_name` (text) - `holiday_count` (number) - `holidays` (list) - `last_date` (text) - `month` (number) - `year` (number) **Example output** ```json { "calendar": "gregorian", "day_count": 31, "days": [ { "gregorian": { "date": "23-08-2026", "date_iso": "2026-08-23", "day": "23", "day_number": 23, "format": "DD-MM-YYYY", "lunarSighting": false, "month_en": "August", "month_number": 8, "weekday_en": "Sunday", "year": "2026", "year_number": 2026 }, "gregorian_date": "2026-08-23", "hijri": { "adjusted_holidays": [], "date": "10-03-1448", "day": "10", "day_number": 10, "days_in_month": 29, "described": "10 Rabi al-awwal 1448 AH", "format": "DD-MM-YYYY", "holidays": [], "is_holiday": false, "method": "HJCoSA", "month_ar": "\u0631\u0628\u064a\u0639 \u0627\u0644\u0623\u0648\u0644", "month_en": "Rabi al-awwal", "month_number": 3, "weekday_ar": "\u0627\u0644\u0627\u062d\u062f", "weekday_en": "Al Ahad", "year": "1448", "year_number": 1448 }, "hijri_date": "10-03-1448", "hijri_described": "10 Rabi al-awwal 1448 AH", "holidays": [], "is_holiday": false, "requested_date": "2026-08-23" } ], "first_date": "2026-08-01", "holiday_count": 7, "holidays": [], "last_date": "2026-08-31", "month": 8, "year": 2026 } ``` ### Get the Hijri dates for a Gregorian month Get every day of a Gregorian month with its Hijri date and any holidays on it. Use it to build a month view that shows both calendars, or to find which days of next month are observances. **Inputs** - Month (`month`, text, required): The Gregorian month to convert. One of: `1` (January), `2` (February), `3` (March), `4` (April), `5` (May), `6` (June), `7` (July), `8` (August), `9` (September), `10` (October), `11` (November), `12` (December). - Year (`year`, number, required): The Gregorian year the month falls in. A Hijri month straddles two Gregorian ones, so the answer normally spans two of them. From 1000 to 9999. - Hijri calendar method (`calendar_method`, text): How a Gregorian date is turned into a Hijri one. Defaults to the High Judiciary Council of Saudi Arabia, which is what aladhan.com itself shows. Run 'List Hijri calendar methods' to see what each covers. One of: `HJCoSA` (High Judiciary Council of Saudi Arabia (default)), `UAQ` (Umm al-Qura), `DIYANET` (Diyanet Isleri Baskanligi, Turkey), `MATHEMATICAL` (Mathematical calculation). - Day adjustment (`adjustment`, number): Shift the converted Hijri date by whole days, from -5 to 5, for a local moon sighting that ran a day ahead or behind. AlAdhan applies it only under the Mathematical calendar method, so choose that method too. From -5 to 5. **Outputs** - `calendar` (text) - `day_count` (number) - `days` (list) - `first_date` (text) - `holiday_count` (number) - `holidays` (list) - `last_date` (text) - `month` (number) - `year` (number) **Example output** ```json { "calendar": "gregorian", "day_count": 31, "days": [ { "gregorian": { "date": "23-08-2026", "date_iso": "2026-08-23", "day": "23", "day_number": 23, "format": "DD-MM-YYYY", "lunarSighting": false, "month_en": "August", "month_number": 8, "weekday_en": "Sunday", "year": "2026", "year_number": 2026 }, "gregorian_date": "2026-08-23", "hijri": { "adjusted_holidays": [], "date": "10-03-1448", "day": "10", "day_number": 10, "days_in_month": 29, "described": "10 Rabi al-awwal 1448 AH", "format": "DD-MM-YYYY", "holidays": [], "is_holiday": false, "method": "HJCoSA", "month_ar": "\u0631\u0628\u064a\u0639 \u0627\u0644\u0623\u0648\u0644", "month_en": "Rabi al-awwal", "month_number": 3, "weekday_ar": "\u0627\u0644\u0627\u062d\u062f", "weekday_en": "Al Ahad", "year": "1448", "year_number": 1448 }, "hijri_date": "10-03-1448", "hijri_described": "10 Rabi al-awwal 1448 AH", "holidays": [], "is_holiday": false, "requested_date": "2026-08-23" } ], "first_date": "2026-08-01", "holiday_count": 7, "holidays": [], "last_date": "2026-08-31", "month": 8, "year": 2026 } ``` ### Get the Hijri year of a Gregorian year's Ramadan Find which Hijri year holds the Ramadan that falls in a given Gregorian year. A Hijri year is eleven days shorter than a Gregorian one, so the two drift: this is the lookup that turns 'Ramadan 2027' into the year number the calendar actions take. **Inputs** - Gregorian year (`year`, number): The Gregorian year Ramadan falls in. Leave empty for this year. From 1000 to 9999. **Outputs** - `gregorian_year` (number) - `hijri_year` (number) - `ramadan_month` (number) - `ramadan_month_name` (text) **Example output** ```json { "gregorian_year": 2027, "hijri_year": 1448, "ramadan_month": 9, "ramadan_month_name": "Ramadan" } ``` ### Get the holidays on a Hijri day Get the holidays that fall on one day of the Hijri calendar, such as the tenth of Dhu al-Hijjah. A day with nothing on it comes back as an empty list rather than as an error, so a workflow can check any day and branch on the answer. **Inputs** - Hijri day (`hijri_day`, number, required): The day of the Hijri month, from 1 to 30. A Hijri month never has thirty-one days. From 1 to 30. - Hijri month (`hijri_month`, text, required): The month of the Hijri calendar. One of: `1` (1. Muharram), `2` (2. Safar), `3` (3. Rabi al-awwal), `4` (4. Rabi al-thani), `5` (5. Jumada al-ula), `6` (6. Jumada al-akhirah), `7` (7. Rajab), `8` (8. Shaban), `9` (9. Ramadan), `10` (10. Shawwal), `11` (11. Dhu al-Qadah), `12` (12. Dhu al-Hijjah). **Outputs** - `count` (number) - `hijri_day` (number) - `hijri_month` (number) - `hijri_month_name` (text) - `holidays` (list) - `is_holiday` (true/false) **Example output** ```json { "count": 2, "hijri_day": 10, "hijri_month": 12, "hijri_month_name": "Dhu al-Hijjah", "holidays": [ "Eid-ul-Adha", "Hajj" ], "is_holiday": true } ``` ### Get the next Hijri holiday Get the next holiday in the Hijri calendar, the Gregorian date it falls on and how many days there are until it. Run it on a schedule to announce what is coming without keeping a list of dates anywhere. **Inputs** - Hijri calendar method (`calendar_method`, text): How a Gregorian date is turned into a Hijri one. Defaults to the High Judiciary Council of Saudi Arabia, which is what aladhan.com itself shows. Run 'List Hijri calendar methods' to see what each covers. One of: `HJCoSA` (High Judiciary Council of Saudi Arabia (default)), `UAQ` (Umm al-Qura), `DIYANET` (Diyanet Isleri Baskanligi, Turkey), `MATHEMATICAL` (Mathematical calculation). - Day adjustment (`adjustment`, number): Shift the converted Hijri date by whole days, from -5 to 5, for a local moon sighting that ran a day ahead or behind. AlAdhan applies it only under the Mathematical calendar method, so choose that method too. From -5 to 5. **Outputs** - `days_until` (number) - `gregorian` (object) - `gregorian_date` (text) - `hijri` (object) - `hijri_date` (text) - `hijri_described` (text) - `holidays` (list) - `is_holiday` (true/false) - `names` (list) **Example output** ```json { "days_until": 2, "gregorian": { "date": "23-08-2026", "date_iso": "2026-08-23", "day": "23", "day_number": 23, "format": "DD-MM-YYYY", "lunarSighting": false, "month_en": "August", "month_number": 8, "weekday_en": "Sunday", "year": "2026", "year_number": 2026 }, "gregorian_date": "2026-08-25", "hijri": { "adjusted_holidays": [], "date": "10-03-1448", "day": "10", "day_number": 10, "days_in_month": 29, "described": "10 Rabi al-awwal 1448 AH", "format": "DD-MM-YYYY", "holidays": [], "is_holiday": false, "method": "HJCoSA", "month_ar": "\u0631\u0628\u064a\u0639 \u0627\u0644\u0623\u0648\u0644", "month_en": "Rabi al-awwal", "month_number": 3, "weekday_ar": "\u0627\u0644\u0627\u062d\u062f", "weekday_en": "Al Ahad", "year": "1448", "year_number": 1448 }, "hijri_date": "12-03-1448", "hijri_described": "12 Rabi al-awwal 1448 AH", "holidays": [ "Mawlid (Birth) al-Nabi" ], "is_holiday": true, "names": [ "Mawlid (Birth) al-Nabi" ] } ``` ### Get the next prayer Get the next prayer due at a place and how many minutes there are until it. Use it for the reminder a workflow actually sends: 'Maghrib in 20 minutes'. Name the place by city and country, by address, or by coordinates. **Inputs** - Date (`date`, date): The day to get times for. Leave empty for today in the place you asked about. - City (`city`, text): Fill in one of three ways to name the place: a city and its country, an address, or a latitude and longitude. The city, used together with the country below. - Country (`country`, text): The country the city is in. Required whenever a city is given. One of: `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua & Barbuda), `AR` (Argentina), `AM` (Armenia), and 239 more. - State or region (`state`, text): Optional, and only useful alongside a city: it tells apart the places that share a name, such as Springfield in Illinois and Springfield in Missouri. - Address (`address`, text): Fill in one of three ways to name the place: a city and its country, an address, or a latitude and longitude. A street address, a postcode or a place written as one line. Use it when you have an address rather than a city. - Latitude (`latitude`, number): Fill in one of three ways to name the place: a city and its country, an address, or a latitude and longitude. Latitude in decimal degrees, from -90 to 90. Coordinates are the exact way to name a place, and the only one that reports the position back unmasked. From -90 to 90. - Longitude (`longitude`, number): Longitude in decimal degrees, from -180 to 180. The Americas take a negative longitude. From -180 to 180. - Calculation method (`method`, text): Which authority's angles to compute the times with. Leave empty and AlAdhan uses the authority closest to the place, which is right far more often than a guess. Run 'List calculation methods' to see the angles each one sets. One of: `0` (Shia Ithna-Ashari, Leva Institute, Qum), `1` (University of Islamic Sciences, Karachi), `2` (Islamic Society of North America (ISNA)), `3` (Muslim World League), `4` (Umm Al-Qura University, Makkah), `5` (Egyptian General Authority of Survey), `7` (Institute of Geophysics, University of Tehran), `8` (Gulf Region), `9` (Kuwait), `10` (Qatar), and 13 more. - Asr calculation (`school`, text): Which juristic method places Asr. The Hanafi position puts it later in the afternoon than the other three schools. Defaults to the majority position. One of: `0` (Shafi, Maliki and Hanbali (the majority position)), `1` (Hanafi (Asr later in the afternoon)). - Midnight calculation (`midnight_mode`, text): Where midnight falls: halfway from sunset to sunrise, or halfway from sunset to Fajr. Defaults to the first. One of: `0` (Standard: halfway from sunset to sunrise), `1` (Jafari: halfway from sunset to Fajr). - High latitude rule (`high_latitude_rule`, text): What to do where the sun never drops far enough below the horizon for Fajr and Isha to have a true time, which is most of northern Europe in summer. Only worth setting above roughly 48 degrees of latitude. One of: `1` (Middle of the night), `2` (One seventh of the night), `3` (Angle based). - Shafaq (`shafaq`, text): Which twilight places Isha. Applies only to the Moonsighting Committee Worldwide method, and is ignored with any other, so it is sent only when that method is chosen. One of: `general`, `ahmer` (Ahmer: the red twilight), `abyad` (Abyad: the white twilight). - Timezone (`timezone`, text): The timezone to report the times in. Leave empty and AlAdhan works it out from the place, which is almost always what you want. It also decides what 'today' means when the date is left blank. One of: `UTC`, `Africa/Abidjan`, `Africa/Accra`, `Africa/Addis_Ababa` (Africa/Addis Ababa), `Africa/Algiers`, `Africa/Asmara`, `Africa/Bamako`, `Africa/Bangui`, `Africa/Banjul`, `Africa/Bissau`, and 439 more. - Hijri calendar method (`calendar_method`, text): How a Gregorian date is turned into a Hijri one. Defaults to the High Judiciary Council of Saudi Arabia, which is what aladhan.com itself shows. Run 'List Hijri calendar methods' to see what each covers. One of: `HJCoSA` (High Judiciary Council of Saudi Arabia (default)), `UAQ` (Umm al-Qura), `DIYANET` (Diyanet Isleri Baskanligi, Turkey), `MATHEMATICAL` (Mathematical calculation). - Adjust Imsak (`tune_imsak`, number): Minutes to shift Imsak by, from -120 to 120. Imsak is the end of the pre-dawn meal. Leave empty for no adjustment. From -120 to 120. - Adjust Fajr (`tune_fajr`, number): Minutes to shift Fajr by, from -120 to 120. A local mosque commonly runs a minute or two later. Leave empty for no adjustment. From -120 to 120. - Adjust Sunrise (`tune_sunrise`, number): Minutes to shift Sunrise by, from -120 to 120. Sunrise ends the time for Fajr. Leave empty for no adjustment. From -120 to 120. - Adjust Dhuhr (`tune_dhuhr`, number): Minutes to shift Dhuhr by, from -120 to 120. Dhuhr is the midday prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Asr (`tune_asr`, number): Minutes to shift Asr by, from -120 to 120. Asr is the afternoon prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Maghrib (`tune_maghrib`, number): Minutes to shift Maghrib by, from -120 to 120. Maghrib is the sunset prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Sunset (`tune_sunset`, number): Minutes to shift Sunset by, from -120 to 120. Sunset is the marker Maghrib is measured from. Leave empty for no adjustment. From -120 to 120. - Adjust Isha (`tune_isha`, number): Minutes to shift Isha by, from -120 to 120. Isha is the night prayer. Leave empty for no adjustment. From -120 to 120. - Adjust Midnight (`tune_midnight`, number): Minutes to shift Midnight by, from -120 to 120. Midnight marks the last third of the night. Leave empty for no adjustment. From -120 to 120. **Outputs** - `date` (object) - `endpoint` (text) - `iso8601` (text) - `location` (object) - `meta` (object) - `minutes_until` (number) - `name` (text) - `prayer` (object) - `prayer_times` (list) - `prayers` (list) - `requested_date` (text) - `settings` (object) - `time` (text) - `timings` (object) - `timings_iso8601` (object) **Example output** ```json { "date": { "date": "2026-08-23", "gregorian": { "date": "23-08-2026", "date_iso": "2026-08-23", "day": "23", "day_number": 23, "format": "DD-MM-YYYY", "lunarSighting": false, "month_en": "August", "month_number": 8, "weekday_en": "Sunday", "year": "2026", "year_number": 2026 }, "hijri": { "adjusted_holidays": [], "date": "10-03-1448", "day": "10", "day_number": 10, "days_in_month": 29, "described": "10 Rabi al-awwal 1448 AH", "format": "DD-MM-YYYY", "holidays": [], "is_holiday": false, "method": "HJCoSA", "month_ar": "\u0631\u0628\u064a\u0639 \u0627\u0644\u0623\u0648\u0644", "month_en": "Rabi al-awwal", "month_number": 3, "weekday_ar": "\u0627\u0644\u0627\u062d\u062f", "weekday_en": "Al Ahad", "year": "1448", "year_number": 1448 }, "hijri_date": "10 Rabi al-awwal 1448 AH", "holidays": [], "readable": "23 Aug 2026", "timestamp": 1787464800 }, "endpoint": "nextPrayerByAddress", "iso8601": "2026-08-23T04:12:00+01:00", "location": { "city": "London", "country": "GB", "described": "London, GB", "kind": "city" }, "meta": { "coordinates_masked": false, "latitude": 51.50853, "latitudeAdjustmentMethod": "ANGLE_BASED", "longitude": -0.12574, "method_id": 2, "method_name": "Islamic Society of North America (ISNA)", "midnightMode": "STANDARD", "offsets": {}, "school": "STANDARD", "timezone": "Europe/London" }, "minutes_until": 248, "name": "Fajr", "prayer": { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T04:12:00+01:00", "name": "Fajr", "time": "04:12" }, "prayer_times": [ { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T04:12:00+01:00", "name": "Fajr", "time": "04:12" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T13:03:00+01:00", "name": "Dhuhr", "time": "13:03" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T16:56:00+01:00", "name": "Asr", "time": "16:56" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T20:07:00+01:00", "name": "Maghrib", "time": "20:07" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T21:53:00+01:00", "name": "Isha", "time": "21:53" } ], "prayers": [ { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T04:12:00+01:00", "name": "Fajr", "time": "04:12" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T13:03:00+01:00", "name": "Dhuhr", "time": "13:03" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T16:56:00+01:00", "name": "Asr", "time": "16:56" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T20:07:00+01:00", "name": "Maghrib", "time": "20:07" }, { "date": "2026-08-23", "is_prayer": true, "iso8601": "2026-08-23T21:53:00+01:00", "name": "Isha", "time": "21:53" } ], "requested_date": "2026-08-23", "settings": { "calendar_method": null, "high_latitude_rule": null, "method": 2, "method_name": "Islamic Society of North America (ISNA)", "midnight_mode": null, "school": null, "shafaq": null, "timezone": null, "tune": null }, "time": "04:12", "timings": { "Fajr": "04:12" } } ``` ### Get the Qibla direction Get the compass bearing from a set of coordinates to the Kaaba in Makkah. The answer carries the exact bearing, a rounded one, and the compass point it corresponds to, plus the address of a compass picture showing it. **Inputs** - Latitude (`latitude`, number, required): Latitude in decimal degrees, from -90 to 90. From -90 to 90. - Longitude (`longitude`, number, required): Longitude in decimal degrees, from -180 to 180. The Americas take a negative longitude. From -180 to 180. **Outputs** - `compass_image_url` (text) - `compass_point` (text) - `described` (text) - `direction` (number) - `direction_rounded` (number) - `kaaba_latitude` (number) - `kaaba_longitude` (number) - `latitude` (number) - `longitude` (number) **Example output** ```json { "compass_image_url": "https://api.aladhan.com/v1/qibla/51.50853/-0.12574/compass", "compass_point": "ESE", "described": "119.0 degrees (ESE)", "direction": 118.98721475, "direction_rounded": 119.0, "kaaba_latitude": 21.4224779, "kaaba_longitude": 39.8251832, "latitude": 51.50853, "longitude": -0.12574 } ``` ### List a Hijri year's holidays List every holiday of a Hijri year with the Gregorian date each one falls on. Use it to fill a calendar a year at a time. AlAdhan sends one entry per observance, so days that carry several are merged here and the count is a count of days. **Inputs** - Hijri year (`hijri_year`, number, required): The Hijri year, from 1356 AH to 1500 AH, which is the range AlAdhan's calendars are tabulated for. Run 'Get the current Islamic date' if you need to know which year it is now. From 1356 to 1500. - Hijri calendar method (`calendar_method`, text): How a Gregorian date is turned into a Hijri one. Defaults to the High Judiciary Council of Saudi Arabia, which is what aladhan.com itself shows. Run 'List Hijri calendar methods' to see what each covers. One of: `HJCoSA` (High Judiciary Council of Saudi Arabia (default)), `UAQ` (Umm al-Qura), `DIYANET` (Diyanet Isleri Baskanligi, Turkey), `MATHEMATICAL` (Mathematical calculation). - Day adjustment (`adjustment`, number): Shift the converted Hijri date by whole days, from -5 to 5, for a local moon sighting that ran a day ahead or behind. AlAdhan applies it only under the Mathematical calendar method, so choose that method too. From -5 to 5. **Outputs** - `count` (number) - `first_date` (text) - `hijri_year` (number) - `holidays` (list) - `last_date` (text) - `name_count` (number) **Example output** ```json { "count": 61, "first_date": "2026-06-16", "hijri_year": 1448, "holidays": [ { "days_until": 2, "gregorian": { "date": "23-08-2026", "date_iso": "2026-08-23", "day": "23", "day_number": 23, "format": "DD-MM-YYYY", "lunarSighting": false, "month_en": "August", "month_number": 8, "weekday_en": "Sunday", "year": "2026", "year_number": 2026 }, "gregorian_date": "2026-08-25", "hijri": { "adjusted_holidays": [], "date": "10-03-1448", "day": "10", "day_number": 10, "days_in_month": 29, "described": "10 Rabi al-awwal 1448 AH", "format": "DD-MM-YYYY", "holidays": [], "is_holiday": false, "method": "HJCoSA", "month_ar": "\u0631\u0628\u064a\u0639 \u0627\u0644\u0623\u0648\u0644", "month_en": "Rabi al-awwal", "month_number": 3, "weekday_ar": "\u0627\u0644\u0627\u062d\u062f", "weekday_en": "Al Ahad", "year": "1448", "year_number": 1448 }, "hijri_date": "12-03-1448", "hijri_described": "12 Rabi al-awwal 1448 AH", "holidays": [ "Mawlid (Birth) al-Nabi" ], "is_holiday": true, "names": [ "Mawlid (Birth) al-Nabi" ] } ], "last_date": "2027-06-04", "name_count": 77 } ``` ### List calculation methods List every prayer-times calculation method AlAdhan supports, with the Fajr and Isha angles each one sets and the place it is associated with. Run it once to see which authority a region follows before pinning a workflow to one. **Inputs**: None. **Outputs** - `count` (number) - `methods` (list) - `selectable_count` (number) **Example output** ```json { "count": 24, "methods": [ { "id": 2, "is_selectable": true, "key": "ISNA", "location": { "latitude": 39.7042123, "longitude": -86.3994387 }, "name": "Islamic Society of North America (ISNA)", "params": { "Fajr": 15, "Isha": 15 } }, { "id": 3, "is_selectable": true, "key": "MWL", "location": { "latitude": 51.5194682, "longitude": -0.1360365 }, "name": "Muslim World League", "params": { "Fajr": 18, "Isha": 17 } } ], "selectable_count": 23 } ``` ### List Hijri calendar methods List the ways AlAdhan can turn a Gregorian date into a Hijri one, with what each is based on and the range of years it is tabulated for. Read it before changing the calendar method on any of the other actions. **Inputs**: None. **Outputs** - `count` (number) - `methods` (list) **Example output** ```json { "count": 4, "methods": [ { "description": "The Umm al-Qura calendar, adjusted after reported sightings.", "id": "HJCoSA", "is_default": true, "is_selectable": true, "name": "High Judiciary Council of Saudi Arabia", "validity": "1356 AH (14 March 1937 CE) to 1500 AH (16 November 2077 CE)" } ] } ``` ### List the Islamic months List the twelve months of the Hijri calendar with their names in English and Arabic and the number each one takes in the other actions here. **Inputs**: None. **Outputs** - `count` (number) - `months` (list) **Example output** ```json { "count": 12, "months": [ { "ar": "\u0645\u062d\u0631\u0645", "en": "Muharram", "number": 1 }, { "ar": "\u0631\u0645\u0636\u0627\u0646", "en": "Ramadan", "number": 9 } ] } ``` ### List the Islamic special days List every special day of the Hijri calendar by the day and month it sits on. This is the fixed list, the same whatever the year, so it is the reference to check a day against without asking for a particular year's calendar. **Inputs**: None. **Outputs** - `count` (number) - `month_count` (number) - `special_days` (list) **Example output** ```json { "count": 78, "month_count": 12, "special_days": [ { "day": 10, "month": 1, "month_ar": "\u0645\u062d\u0631\u0645", "month_en": "Muharram", "name": "Ashura" }, { "day": 27, "month": 9, "month_ar": "\u0631\u0645\u0636\u0627\u0646", "month_en": "Ramadan", "name": "Laylat al-Qadr" } ] } ``` ### List the names of Allah List all ninety-nine names of Allah in Arabic, with their transliteration and their meaning in English. A search term narrows the list to the names whose transliteration or meaning contains it, which is matched here since the API takes no search of its own. **Inputs** - Search (`search`, text): Optional. Keep only the names whose transliteration or meaning contains this text. Leave empty for all ninety-nine. **Outputs** - `count` (number) - `names` (list) - `search` (text) - `total_count` (number) **Example output** ```json { "count": 99, "names": [ { "arabic": "\u0627\u0644\u0631\u062d\u0645\u0646", "meaning": "The Beneficent", "name": "\u0627\u0644\u0631\u062d\u0645\u0646", "number": 1, "transliteration": "Ar Rahmaan" }, { "arabic": "\u0627\u0644\u0631\u062d\u064a\u0645", "meaning": "The Merciful", "name": "\u0627\u0644\u0631\u062d\u064a\u0645", "number": 2, "transliteration": "Ar Raheem" } ], "search": null, "total_count": 99 } ```