GET /v2/times/month.json

Returns today's prayer times based on given zone.

Resource URL

https://api.pray.zone/v2/times/month.json

Parameters

{format}typeoptionaldecription
{month_year}stringRequiredWe use a key to avoid abuse on our API. The API is Free!
https://api.pray.zone/v2/times/month.json?city=mecca&month=2020-07
{city}stringRequiredThe city id is the name of the city, the space are replaced with "-". The list of the cities and id are accessible here.
Required if {longitude}|{latitude}|{elevation} or {ip} is missing.
https://api.pray.zone/v2/times/month.json?city=mecca&month=2020-07
{longitude}
{latitude}
{elevation}		stringRequired

Required if {longitude}|{latitude}|{elevation} or {city} is missing.
https://api.pray.zone/v2/times/month.json?longitude=39.81666564941406&latitude=21.416667938232425&elevation=333&month=2020-07

longitudeLongitude must be between -180 and 180 degrees inclusive
latitudeLongitude must be between -90 and 90 degrees inclusive
elevationElevation must be between -2000 and 8000 meters inclusive
{ip}stringRequiredOnly IPv4 are allowed
Required if {city} or {ip} is missing.
https://api.pray.zone/v2/times/month.json?ip=163.172.18.192&month=2020-07
{key}stringoptionalWe use a key to avoid abuse on our API. The API is Free!
https://api.pray.zone/v2/times/month.json?city=mecca&month=2020-07&key=MagicKey
{school}intoptional

Each countries has an default assigned school, the list of school by countries is accessible here.
https://api.pray.zone/v2/times/month.json?city=mecca&month=2020-07&school=2

IdNameFajrIsha
0Ithna Ashari1614
1University of Islamic Sciences, Karachi1818
2Islamic Society of North America1515
3Muslim World League1817
4Umm Al-Qura University, Mecca18.590
5Egyptian General Authority of Survey1818
7Institute of Geophysics, University of Tehran17.714
8Morocco1918
9Department of Islamic Advancement, Malaysia (JAKIM)2018
10Majlis Ugama Islam Singapura2018
11Union des Organisations Islamiques de France1212
12Turkey1212
{juristic}intoptional

0 for Shafii (or the standard way), 1 for Hanafi. If you leave this empty, it defaults to Shafii.
https://api.pray.zone/v2/times/month.json?city=mecca&month=2020-07&juristic=1

IdJuristic
0Shafii (default)
1Hanafi
{highlat}intoptional

In locations at higher latitude, twilight may persist throughout the night during some months of the year. In these abnormal periods, the determination of Fajr and Isha is not possible using the usual formulas mentioned in the previous section. To overcome this problem, several solutions have been proposed, three of which are described below.
https://api.pray.zone/v2/times/month.json?city=mecca&month=2020-07&highlat=2

School nameSchool idDescription
None (default)0No adjustment
Midnight1The period from sunset to sunrise is divided into two halves. The first half is considered to be the "night" and the other half as "day break". Fajr and Isha in this method are assumed to be at mid-night during the abnormal periods.
One-Seventh of the Night2The period between sunset and sunrise is divided into seven parts. Isha begins after the first one-seventh part, and Fajr is at the beginning of the seventh part.
Angle Based3This is an intermediate solution, used by some recent prayer time calculators. Let a be the twilight angle for Isha, and let t = a/60. The period between sunset and sunrise is divided into t parts. Isha begins after the first part. For example, if the twilight angle for Isha is 15, then Isha begins at the end of the first quarter (15/60) of the night. Time for Fajr is calculated similarly.
{timeformat}intoptional

Time format
https://api.pray.zone/v2/times/month.json?city=mecca&month=2020-07&timeformat=1

Time formatTime IDExample:
24-hour format (default)009:00, 15:45, 22:12
12-hour format109:00 am, 03:45 pm, 10:12 pm
12-hour format with no suffix209:00, 03:45, 10:12

Parameters

{format}typeoptionaldecription
{key}stringNoWe use a key to avoid abuse on our API. The API is Free!
{city}stringNoThe city id is the name of the city, the space are replaced with "-". The list of the cities and id are accessible here.
{school}intYes

Each countries has an default assigned school, the list of school by countries is accessible here.

IdNameFajrIsha
0Ithna Ashari1614
1University of Islamic Sciences, Karachi1818
2Islamic Society of North America1515
3Muslim World League1817
4Umm Al-Qura University, Mecca18.590
5Egyptian General Authority of Survey1818
7Institute of Geophysics, University of Tehran17.714
8Morocco1918
9Department of Islamic Advancement, Malaysia (JAKIM)2018
10Majlis Ugama Islam Singapura2018
11Union des Organisations Islamiques de France1212
12Turkey1212
{juristic}intYes

0 for Shafii (or the standard way), 1 for Hanafi. If you leave this empty, it defaults to Shafii.

IdJuristic
0Shafii (default)
1Hanafi
{higher-latitudes}intYes

In locations at higher latitude, twilight may persist throughout the night during some months of the year. In these abnormal periods, the determination of Fajr and Isha is not possible using the usual formulas mentioned in the previous section. To overcome this problem, several solutions have been proposed, three of which are described below.

School nameSchool idDescription
None (default)0No adjustment
Midnight1The period from sunset to sunrise is divided into two halves. The first half is considered to be the "night" and the other half as "day break". Fajr and Isha in this method are assumed to be at mid-night during the abnormal periods.
One-Seventh of the Night2The period between sunset and sunrise is divided into seven parts. Isha begins after the first one-seventh part, and Fajr is at the beginning of the seventh part.
Angle Based3This is an intermediate solution, used by some recent prayer time calculators. Let a be the twilight angle for Isha, and let t = a/60. The period between sunset and sunrise is divided into t parts. Isha begins after the first part. For example, if the twilight angle for Isha is 15, then Isha begins at the end of the first quarter (15/60) of the night. Time for Fajr is calculated similarly.
{time-format}intYes

Time format

Time formatTime IDExample:
24-hour format (default)009:00, 15:45, 22:12
12-hour format109:00 am, 03:45 pm, 10:12 pm
12-hour format with no suffix209:00, 03:45, 10:12
{day}stringYesWe use a key to avoid abuse on our API. The API is Free!
{month-year}stringYesWe use a key to avoid abuse on our API. The API is Free!

Example Request

https://api.pray.zone/v2/times/month.json?city=mecca&month=2020-07

Example Result

{
  "code": 200,
  "status": "OK",
  "results": {
    "datetime": [
      {
        "times": {
          "Imsak": "04:07",
          "Sunrise": "05:39",
          "Fajr": "04:17",
          "Dhuhr": "12:25",
          "Asr": "15:43",
          "Sunset": "19:10",
          "Maghrib": "19:22",
          "Isha": "-",
          "Midnight": "23:44"
        },
        "date": {
          "timestamp": 1593561600,
          "gregorian": "2020-07-01",
          "hijri": "1441-11-10"
        }
      },
      {
        "times": {
          "Imsak": "04:08",
          "Sunrise": "05:40",
          "Fajr": "04:18",
          "Dhuhr": "12:25",
          "Asr": "15:43",
          "Sunset": "19:10",
          "Maghrib": "19:22",
          "Isha": "-",
          "Midnight": "23:44"
        },
        "date": {
          "timestamp": 1593648000,
          "gregorian": "2020-07-02",
          "hijri": "1441-11-11"
        }
      },
      {
        "times": {
          "Imsak": "04:08",
          "Sunrise": "05:40",
          "Fajr": "04:18",
          "Dhuhr": "12:25",
          "Asr": "15:43",
          "Sunset": "19:10",
          "Maghrib": "19:22",
          "Isha": "-",
          "Midnight": "23:44"
        },
        "date": {
          "timestamp": 1593734400,
          "gregorian": "2020-07-03",
          "hijri": "1441-11-12"
        }
      },
      {
        "times": {
          "Imsak": "04:08",
          "Sunrise": "05:40",
          "Fajr": "04:18",
          "Dhuhr": "12:25",
          "Asr": "15:43",
          "Sunset": "19:10",
          "Maghrib": "19:22",
          "Isha": "-",
          "Midnight": "23:44"
        },
        "date": {
          "timestamp": 1593820800,
          "gregorian": "2020-07-04",
          "hijri": "1441-11-13"
        }
      },
      {
        "times": {
          "Imsak": "04:09",
          "Sunrise": "05:41",
          "Fajr": "04:19",
          "Dhuhr": "12:25",
          "Asr": "15:43",
          "Sunset": "19:10",
          "Maghrib": "19:22",
          "Isha": "-",
          "Midnight": "23:45"
        },
        "date": {
          "timestamp": 1593907200,
          "gregorian": "2020-07-05",
          "hijri": "1441-11-14"
        }
      },
      {
        "times": {
          "Imsak": "04:09",
          "Sunrise": "05:41",
          "Fajr": "04:19",
          "Dhuhr": "12:26",
          "Asr": "15:43",
          "Sunset": "19:10",
          "Maghrib": "19:22",
          "Isha": "-",
          "Midnight": "23:45"
        },
        "date": {
          "timestamp": 1593993600,
          "gregorian": "2020-07-06",
          "hijri": "1441-11-15"
        }
      },
      {
        "times": {
          "Imsak": "04:10",
          "Sunrise": "05:41",
          "Fajr": "04:20",
          "Dhuhr": "12:26",
          "Asr": "15:43",
          "Sunset": "19:10",
          "Maghrib": "19:22",
          "Isha": "-",
          "Midnight": "23:45"
        },
        "date": {
          "timestamp": 1594080000,
          "gregorian": "2020-07-07",
          "hijri": "1441-11-16"
        }
      }
    ],
    "location": {
      "latitude": 21.416667938232425,
      "longitude": 39.816665649414062,
      "elevation": 333.0,
      "city": "Mecca",
      "country": "Saudi Arabia",
      "country_code": "SA",
      "timezone": "Asia/Riyadh",
      "local_offset": 3.0
    },
    "settings": {
      "timeformat": "HH:mm",
      "school": "Ithna Ashari",
      "juristic": "Shafii",
      "highlat": "None",
      "fajr_angle": 18.5,
      "isha_angle": 90.0
    }
  }
}