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} | type | optional | decription | ||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| {month_year} | string | Required | We use a key to avoid abuse on our API. The API is Free! https://api.pray.zone/v2/times/month.json?city=mecca&month=2021-01 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
| {city} | string | Required | The 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=2021-01 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
| {longitude} {latitude} {elevation} | string | Required | Required if {longitude}|{latitude}|{elevation} or {city} is missing.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
| {ip} | string | Required | Only IPv4 are allowed Required if {city} or {ip} is missing. https://api.pray.zone/v2/times/month.json?ip=163.172.18.192&month=2021-01 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
| {key} | string | optional | We use a key to avoid abuse on our API. The API is Free! https://api.pray.zone/v2/times/month.json?city=mecca&month=2021-01&key=MagicKey | ||||||||||||||||||||||||||||||||||||||||||||||||||||
| {school} | int | optional | Each countries has an default assigned school, the list of school by countries is accessible here.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
| {juristic} | int | optional | 0 for Shafii (or the standard way), 1 for Hanafi. If you leave this empty, it defaults to Shafii.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
| {highlat} | int | optional | 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.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
| {timeformat} | int | optional | Time format
|
Parameters
| {format} | type | optional | decription | ||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| {key} | string | No | We use a key to avoid abuse on our API. The API is Free! | ||||||||||||||||||||||||||||||||||||||||||||||||||||
| {city} | string | No | The city id is the name of the city, the space are replaced with "-". The list of the cities and id are accessible here. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
| {school} | int | Yes | Each countries has an default assigned school, the list of school by countries is accessible here.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
| {juristic} | int | Yes | 0 for Shafii (or the standard way), 1 for Hanafi. If you leave this empty, it defaults to Shafii.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
| {higher-latitudes} | int | Yes | 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.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
| {time-format} | int | Yes | Time format
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
| {day} | string | Yes | We use a key to avoid abuse on our API. The API is Free! | ||||||||||||||||||||||||||||||||||||||||||||||||||||
| {month-year} | string | Yes | We 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=2021-01
Example Result
{
"code": 200,
"status": "OK",
"results": {
"datetime": [
{
"times": {
"Imsak": "05:29",
"Sunrise": "06:56",
"Fajr": "05:39",
"Dhuhr": "12:24",
"Asr": "15:29",
"Sunset": "17:53",
"Maghrib": "18:05",
"Isha": "-",
"Midnight": "23:46"
},
"date": {
"timestamp": 1609459200,
"gregorian": "2021-01-01",
"hijri": "1442-05-17"
}
},
{
"times": {
"Imsak": "05:30",
"Sunrise": "06:56",
"Fajr": "05:40",
"Dhuhr": "12:25",
"Asr": "15:30",
"Sunset": "17:54",
"Maghrib": "18:06",
"Isha": "-",
"Midnight": "23:47"
},
"date": {
"timestamp": 1609545600,
"gregorian": "2021-01-02",
"hijri": "1442-05-18"
}
},
{
"times": {
"Imsak": "05:30",
"Sunrise": "06:56",
"Fajr": "05:40",
"Dhuhr": "12:25",
"Asr": "15:30",
"Sunset": "17:54",
"Maghrib": "18:06",
"Isha": "-",
"Midnight": "23:47"
},
"date": {
"timestamp": 1609632000,
"gregorian": "2021-01-03",
"hijri": "1442-05-19"
}
},
{
"times": {
"Imsak": "05:30",
"Sunrise": "06:57",
"Fajr": "05:40",
"Dhuhr": "12:26",
"Asr": "15:31",
"Sunset": "17:55",
"Maghrib": "18:07",
"Isha": "-",
"Midnight": "23:48"
},
"date": {
"timestamp": 1609718400,
"gregorian": "2021-01-04",
"hijri": "1442-05-20"
}
},
{
"times": {
"Imsak": "05:31",
"Sunrise": "06:57",
"Fajr": "05:41",
"Dhuhr": "12:26",
"Asr": "15:32",
"Sunset": "17:56",
"Maghrib": "18:08",
"Isha": "-",
"Midnight": "23:48"
},
"date": {
"timestamp": 1609804800,
"gregorian": "2021-01-05",
"hijri": "1442-05-21"
}
},
{
"times": {
"Imsak": "05:31",
"Sunrise": "06:57",
"Fajr": "05:41",
"Dhuhr": "12:27",
"Asr": "15:32",
"Sunset": "17:56",
"Maghrib": "18:08",
"Isha": "-",
"Midnight": "23:49"
},
"date": {
"timestamp": 1609891200,
"gregorian": "2021-01-06",
"hijri": "1442-05-22"
}
},
{
"times": {
"Imsak": "05:31",
"Sunrise": "06:57",
"Fajr": "05:41",
"Dhuhr": "12:27",
"Asr": "15:33",
"Sunset": "17:57",
"Maghrib": "18:09",
"Isha": "-",
"Midnight": "23:49"
},
"date": {
"timestamp": 1609977600,
"gregorian": "2021-01-07",
"hijri": "1442-05-23"
}
},
{
"times": {
"Imsak": "05:32",
"Sunrise": "06:57",
"Fajr": "05:42",
"Dhuhr": "12:27",
"Asr": "15:33",
"Sunset": "17:58",
"Maghrib": "18:10",
"Isha": "-",
"Midnight": "23:50"
},
"date": {
"timestamp": 1610064000,
"gregorian": "2021-01-08",
"hijri": "1442-05-24"
}
},
{
"times": {
"Imsak": "05:32",
"Sunrise": "06:58",
"Fajr": "05:42",
"Dhuhr": "12:28",
"Asr": "15:34",
"Sunset": "17:58",
"Maghrib": "18:10",
"Isha": "-",
"Midnight": "23:50"
},
"date": {
"timestamp": 1610150400,
"gregorian": "2021-01-09",
"hijri": "1442-05-25"
}
},
{
"times": {
"Imsak": "05:32",
"Sunrise": "06:58",
"Fajr": "05:42",
"Dhuhr": "12:28",
"Asr": "15:35",
"Sunset": "17:59",
"Maghrib": "18:11",
"Isha": "-",
"Midnight": "23:51"
},
"date": {
"timestamp": 1610236800,
"gregorian": "2021-01-10",
"hijri": "1442-05-26"
}
},
{
"times": {
"Imsak": "05:32",
"Sunrise": "06:58",
"Fajr": "05:42",
"Dhuhr": "12:29",
"Asr": "15:35",
"Sunset": "18:00",
"Maghrib": "18:11",
"Isha": "-",
"Midnight": "23:51"
},
"date": {
"timestamp": 1610323200,
"gregorian": "2021-01-11",
"hijri": "1442-05-27"
}
},
{
"times": {
"Imsak": "05:32",
"Sunrise": "06:58",
"Fajr": "05:42",
"Dhuhr": "12:29",
"Asr": "15:36",
"Sunset": "18:00",
"Maghrib": "18:12",
"Isha": "-",
"Midnight": "23:51"
},
"date": {
"timestamp": 1610409600,
"gregorian": "2021-01-12",
"hijri": "1442-05-28"
}
},
{
"times": {
"Imsak": "05:33",
"Sunrise": "06:58",
"Fajr": "05:43",
"Dhuhr": "12:29",
"Asr": "15:36",
"Sunset": "18:01",
"Maghrib": "18:13",
"Isha": "-",
"Midnight": "23:52"
},
"date": {
"timestamp": 1610496000,
"gregorian": "2021-01-13",
"hijri": "1442-05-29"
}
},
{
"times": {
"Imsak": "05:33",
"Sunrise": "06:58",
"Fajr": "05:43",
"Dhuhr": "12:30",
"Asr": "15:37",
"Sunset": "18:02",
"Maghrib": "18:13",
"Isha": "-",
"Midnight": "23:52"
},
"date": {
"timestamp": 1610582400,
"gregorian": "2021-01-14",
"hijri": "1442-06-01"
}
},
{
"times": {
"Imsak": "05:33",
"Sunrise": "06:58",
"Fajr": "05:43",
"Dhuhr": "12:30",
"Asr": "15:38",
"Sunset": "18:02",
"Maghrib": "18:14",
"Isha": "-",
"Midnight": "23:53"
},
"date": {
"timestamp": 1610668800,
"gregorian": "2021-01-15",
"hijri": "1442-06-02"
}
},
{
"times": {
"Imsak": "05:33",
"Sunrise": "06:58",
"Fajr": "05:43",
"Dhuhr": "12:31",
"Asr": "15:38",
"Sunset": "18:03",
"Maghrib": "18:15",
"Isha": "-",
"Midnight": "23:53"
},
"date": {
"timestamp": 1610755200,
"gregorian": "2021-01-16",
"hijri": "1442-06-03"
}
}
],
"location": {
"latitude": 21.416667938232425,
"longitude": 39.81666564941406,
"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
}
}
}