Docs
Open Lodol
DocumentationIntegrationsAPI

AlAdhan

App · Calendars · 22 actions

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.

Actions

ActionWhat it does
Convert a date to the Hijri calendarTurn a Gregorian date into its Hijri one, with the day of the week in English and Arabic and any holiday that falls on it.
Convert a Hijri date to the Gregorian calendarTurn a Hijri date into its Gregorian one.
Get a Hijri month or year of prayer timesGet every day's prayer times for a Hijri month, or for a whole Hijri year when the month is left empty.
Get a month or year of prayer timesGet every day's prayer times for a Gregorian month, or for a whole year when the month is left empty.
Get a Qibla compass imageGet a compass picture marking the Qibla from a set of coordinates, as an image address to put in a message or a page.
Get names of Allah by numberGet one or more of the ninety-nine names by number, chosen from the list.
Get prayer timesGet the day's prayer times for a place: Fajr, Dhuhr, Asr, Maghrib and Isha, alongside Imsak, sunrise, sunset and the thirds of the night.
Get prayer times between two datesGet 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.
Get the current Islamic dateGet the Hijri month and year it is now, in English and Arabic.
Get the Gregorian dates for a Hijri monthGet every day of a Hijri month with its Gregorian date and any holidays on it.
Get the Hijri dates for a Gregorian monthGet every day of a Gregorian month with its Hijri date and any holidays on it.
Get the Hijri year of a Gregorian year's RamadanFind which Hijri year holds the Ramadan that falls in a given Gregorian year.
Get the holidays on a Hijri dayGet the holidays that fall on one day of the Hijri calendar, such as the tenth of Dhu al-Hijjah.
Get the next Hijri holidayGet the next holiday in the Hijri calendar, the Gregorian date it falls on and how many days there are until it.
Get the next prayerGet the next prayer due at a place and how many minutes there are until it.
Get the Qibla directionGet the compass bearing from a set of coordinates to the Kaaba in Makkah.
List a Hijri year's holidaysList every holiday of a Hijri year with the Gregorian date each one falls on.
List calculation methodsList every prayer-times calculation method AlAdhan supports, with the Fajr and Isha angles each one sets and the place it is associated with.
List Hijri calendar methodsList 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.
List the Islamic monthsList 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.
List the Islamic special daysList every special day of the Hijri calendar by the day and month it sits on.
List the names of AllahList all ninety-nine names of Allah in Arabic, with their transliteration and their meaning in English.

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

Datedatedate
The Gregorian date to convert. Leave empty for today.
Hijri calendar methodcalendar_methodtext
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 adjustmentadjustmentnumber
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

gregorianobject
gregorian_datetext
hijriobject
hijri_datetext
hijri_describedtext
holidayslist
is_holidaytrue/false
requested_datetext
Example output
{
  "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 dayhijri_daynumberRequired
The day of the Hijri month, from 1 to 30. A Hijri month never has thirty-one days.From 1 to 30.
Hijri monthhijri_monthtextRequired
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 yearhijri_yearnumberRequired
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 methodcalendar_methodtext
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 adjustmentadjustmentnumber
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

gregorianobject
gregorian_datetext
hijriobject
hijri_datetext
hijri_describedtext
holidayslist
is_holidaytrue/false
requested_hijri_datetext
requested_hijri_month_nametext
Example output
{
  "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 yearhijri_yearnumberRequired
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 monthhijri_monthtext
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).
Citycitytext
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.
Countrycountrytext
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 regionstatetext
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.
Addressaddresstext
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.
Latitudelatitudenumber
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.
Longitudelongitudenumber
Longitude in decimal degrees, from -180 to 180. The Americas take a negative longitude.From -180 to 180.
Calculation methodmethodtext
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 calculationschooltext
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 calculationmidnight_modetext
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 rulehigh_latitude_ruletext
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).
Shafaqshafaqtext
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).
Timezonetimezonetext
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 methodcalendar_methodtext
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 Imsaktune_imsaknumber
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 Fajrtune_fajrnumber
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 Sunrisetune_sunrisenumber
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 Dhuhrtune_dhuhrnumber
Minutes to shift Dhuhr by, from -120 to 120. Dhuhr is the midday prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Asrtune_asrnumber
Minutes to shift Asr by, from -120 to 120. Asr is the afternoon prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Maghribtune_maghribnumber
Minutes to shift Maghrib by, from -120 to 120. Maghrib is the sunset prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Sunsettune_sunsetnumber
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 Ishatune_ishanumber
Minutes to shift Isha by, from -120 to 120. Isha is the night prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Midnighttune_midnightnumber
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

calendartext
day_countnumber
dayslist
first_datetext
hijri_monthnumber
hijri_month_nametext
hijri_yearnumber
last_datetext
locationobject
monthslist
settingsobject
Example output
{
  "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

Yearyearnumber
The Gregorian year. Leave empty for the current year.From 1000 to 9999.
Monthmonthtext
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).
Citycitytext
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.
Countrycountrytext
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 regionstatetext
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.
Addressaddresstext
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.
Latitudelatitudenumber
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.
Longitudelongitudenumber
Longitude in decimal degrees, from -180 to 180. The Americas take a negative longitude.From -180 to 180.
Calculation methodmethodtext
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 calculationschooltext
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 calculationmidnight_modetext
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 rulehigh_latitude_ruletext
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).
Shafaqshafaqtext
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).
Timezonetimezonetext
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 methodcalendar_methodtext
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 Imsaktune_imsaknumber
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 Fajrtune_fajrnumber
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 Sunrisetune_sunrisenumber
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 Dhuhrtune_dhuhrnumber
Minutes to shift Dhuhr by, from -120 to 120. Dhuhr is the midday prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Asrtune_asrnumber
Minutes to shift Asr by, from -120 to 120. Asr is the afternoon prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Maghribtune_maghribnumber
Minutes to shift Maghrib by, from -120 to 120. Maghrib is the sunset prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Sunsettune_sunsetnumber
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 Ishatune_ishanumber
Minutes to shift Isha by, from -120 to 120. Isha is the night prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Midnighttune_midnightnumber
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

calendartext
day_countnumber
dayslist
first_datetext
last_datetext
locationobject
monthnumber
monthslist
settingsobject
yearnumber
Example output
{
  "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

LatitudelatitudenumberRequired
Latitude in decimal degrees, from -90 to 90.From -90 to 90.
LongitudelongitudenumberRequired
Longitude in decimal degrees, from -180 to 180. The Americas take a negative longitude.From -180 to 180.

Outputs

content_typetext
image_urltext
latitudenumber
longitudenumber
size_bytesnumber
Example output
{
  "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

NamesnumberslistRequired
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

countnumber
nameslist
requested_countnumber
requested_numberslist
Example output
{
  "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

Datedatedate
The day to get times for. Leave empty for today in the place you asked about.
Citycitytext
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.
Countrycountrytext
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 regionstatetext
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.
Addressaddresstext
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.
Latitudelatitudenumber
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.
Longitudelongitudenumber
Longitude in decimal degrees, from -180 to 180. The Americas take a negative longitude.From -180 to 180.
Calculation methodmethodtext
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 calculationschooltext
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 calculationmidnight_modetext
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 rulehigh_latitude_ruletext
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).
Shafaqshafaqtext
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).
Timezonetimezonetext
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 methodcalendar_methodtext
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 Imsaktune_imsaknumber
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 Fajrtune_fajrnumber
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 Sunrisetune_sunrisenumber
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 Dhuhrtune_dhuhrnumber
Minutes to shift Dhuhr by, from -120 to 120. Dhuhr is the midday prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Asrtune_asrnumber
Minutes to shift Asr by, from -120 to 120. Asr is the afternoon prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Maghribtune_maghribnumber
Minutes to shift Maghrib by, from -120 to 120. Maghrib is the sunset prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Sunsettune_sunsetnumber
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 Ishatune_ishanumber
Minutes to shift Isha by, from -120 to 120. Isha is the night prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Midnighttune_midnightnumber
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

dateobject
locationobject
metaobject
prayer_timeslist
prayerslist
requested_datetext
settingsobject
timingsobject
timings_iso8601object
Example output
{
  "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 datedate_startdateRequired
First day of the range.
End datedate_enddateRequired
Last day of the range, at most eleven months after the start date.
Citycitytext
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.
Countrycountrytext
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 regionstatetext
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.
Addressaddresstext
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.
Latitudelatitudenumber
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.
Longitudelongitudenumber
Longitude in decimal degrees, from -180 to 180. The Americas take a negative longitude.From -180 to 180.
Calculation methodmethodtext
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 calculationschooltext
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 calculationmidnight_modetext
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 rulehigh_latitude_ruletext
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).
Shafaqshafaqtext
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).
Timezonetimezonetext
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 methodcalendar_methodtext
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 Imsaktune_imsaknumber
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 Fajrtune_fajrnumber
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 Sunrisetune_sunrisenumber
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 Dhuhrtune_dhuhrnumber
Minutes to shift Dhuhr by, from -120 to 120. Dhuhr is the midday prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Asrtune_asrnumber
Minutes to shift Asr by, from -120 to 120. Asr is the afternoon prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Maghribtune_maghribnumber
Minutes to shift Maghrib by, from -120 to 120. Maghrib is the sunset prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Sunsettune_sunsetnumber
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 Ishatune_ishanumber
Minutes to shift Isha by, from -120 to 120. Isha is the night prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Midnighttune_midnightnumber
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

calendartext
date_endtext
date_starttext
day_countnumber
dayslist
first_datetext
last_datetext
locationobject
monthslist
settingsobject
Example output
{
  "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

describedtext
monthnumber
month_artext
month_entext
requests_madenumber
yearnumber
Example output
{
  "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 monthhijri_monthtextRequired
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 yearhijri_yearnumberRequired
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 methodcalendar_methodtext
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 adjustmentadjustmentnumber
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

calendartext
day_countnumber
dayslist
first_datetext
hijri_month_nametext
holiday_countnumber
holidayslist
last_datetext
monthnumber
yearnumber
Example output
{
  "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

MonthmonthtextRequired
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).
YearyearnumberRequired
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 methodcalendar_methodtext
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 adjustmentadjustmentnumber
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

calendartext
day_countnumber
dayslist
first_datetext
holiday_countnumber
holidayslist
last_datetext
monthnumber
yearnumber
Example output
{
  "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 yearyearnumber
The Gregorian year Ramadan falls in. Leave empty for this year.From 1000 to 9999.

Outputs

gregorian_yearnumber
hijri_yearnumber
ramadan_monthnumber
ramadan_month_nametext
Example output
{
  "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 dayhijri_daynumberRequired
The day of the Hijri month, from 1 to 30. A Hijri month never has thirty-one days.From 1 to 30.
Hijri monthhijri_monthtextRequired
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

countnumber
hijri_daynumber
hijri_monthnumber
hijri_month_nametext
holidayslist
is_holidaytrue/false
Example output
{
  "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 methodcalendar_methodtext
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 adjustmentadjustmentnumber
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_untilnumber
gregorianobject
gregorian_datetext
hijriobject
hijri_datetext
hijri_describedtext
holidayslist
is_holidaytrue/false
nameslist
Example output
{
  "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

Datedatedate
The day to get times for. Leave empty for today in the place you asked about.
Citycitytext
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.
Countrycountrytext
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 regionstatetext
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.
Addressaddresstext
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.
Latitudelatitudenumber
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.
Longitudelongitudenumber
Longitude in decimal degrees, from -180 to 180. The Americas take a negative longitude.From -180 to 180.
Calculation methodmethodtext
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 calculationschooltext
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 calculationmidnight_modetext
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 rulehigh_latitude_ruletext
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).
Shafaqshafaqtext
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).
Timezonetimezonetext
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 methodcalendar_methodtext
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 Imsaktune_imsaknumber
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 Fajrtune_fajrnumber
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 Sunrisetune_sunrisenumber
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 Dhuhrtune_dhuhrnumber
Minutes to shift Dhuhr by, from -120 to 120. Dhuhr is the midday prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Asrtune_asrnumber
Minutes to shift Asr by, from -120 to 120. Asr is the afternoon prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Maghribtune_maghribnumber
Minutes to shift Maghrib by, from -120 to 120. Maghrib is the sunset prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Sunsettune_sunsetnumber
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 Ishatune_ishanumber
Minutes to shift Isha by, from -120 to 120. Isha is the night prayer. Leave empty for no adjustment.From -120 to 120.
Adjust Midnighttune_midnightnumber
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

dateobject
endpointtext
iso8601text
locationobject
metaobject
minutes_untilnumber
nametext
prayerobject
prayer_timeslist
prayerslist
requested_datetext
settingsobject
timetext
timingsobject
timings_iso8601object
Example output
{
  "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

LatitudelatitudenumberRequired
Latitude in decimal degrees, from -90 to 90.From -90 to 90.
LongitudelongitudenumberRequired
Longitude in decimal degrees, from -180 to 180. The Americas take a negative longitude.From -180 to 180.

Outputs

compass_image_urltext
compass_pointtext
describedtext
directionnumber
direction_roundednumber
kaaba_latitudenumber
kaaba_longitudenumber
latitudenumber
longitudenumber
Example output
{
  "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 yearhijri_yearnumberRequired
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 methodcalendar_methodtext
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 adjustmentadjustmentnumber
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

countnumber
first_datetext
hijri_yearnumber
holidayslist
last_datetext
name_countnumber
Example output
{
  "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

countnumber
methodslist
selectable_countnumber
Example output
{
  "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

countnumber
methodslist
Example output
{
  "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

countnumber
monthslist
Example output
{
  "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

countnumber
month_countnumber
special_dayslist
Example output
{
  "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

Searchsearchtext
Optional. Keep only the names whose transliteration or meaning contains this text. Leave empty for all ninety-nine.

Outputs

countnumber
nameslist
searchtext
total_countnumber
Example output
{
  "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
}

Al Quran Cloud

Previous Page

Alchemy

Next Page

On this page

ActionsConvert a date to the Hijri calendarConvert a Hijri date to the Gregorian calendarGet a Hijri month or year of prayer timesGet a month or year of prayer timesGet a Qibla compass imageGet names of Allah by numberGet prayer timesGet prayer times between two datesGet the current Islamic dateGet the Gregorian dates for a Hijri monthGet the Hijri dates for a Gregorian monthGet the Hijri year of a Gregorian year's RamadanGet the holidays on a Hijri dayGet the next Hijri holidayGet the next prayerGet the Qibla directionList a Hijri year's holidaysList calculation methodsList Hijri calendar methodsList the Islamic monthsList the Islamic special daysList the names of Allah