Returns this week's prayer times based on given zone.

Resource URL

https://api.azanpro.com/times/this_week.json

Parameters

Parameter	Remark	Description
zone	Required	The location code based on prayer time zones provided by Jakim. Input: Refer to zone codes here.
format	Optional	Options for time formatting Input: One of the values below. Default: timestamp timestamp Show results for prayer times in timestamp format. 12-hour Show results for prayer times in 12-hour format. 24-hour Show results for prayer times in 24-hour format.
pre	Optional	Show result in preformatted text enclosed with <pre> tags. Input: true / false Default: false
dow	Optional	Define the preferred first day of week. Input: sunday / monday Default: monday

Response Fields

Parameter	Description
zone	The location code based on prayer time zones provided by Jakim. Refer to zone codes here.
start	Start date in format `dd-mm-yyyy`.
end	End date in format `dd-mm-yyyy`.
locations	List of locations identified by Jakim for which having similar prayer timezone.
prayer_times	prayer times information based on the selected zone. date Date in format `dd-mm-yyyy`. datestamp Date in unix timestamp (a.k.a. POSIX time or Epoch time) format. imsak The time period which in Malaysia is equal to 10 minutes before fajr timing. subuh The time period within which the Fajr daily prayer MUST be performed. syuruk The time period after the deadline of fajr prayer. It is forbidden to pray during this syuruk time. zohor The time period within which the Dhuhr daily prayer MUST be performed. asar The time period within which the Asr daily prayer MUST be performed. maghrib The time period within which the Maghrib daily prayer MUST be performed. isyak The time period within which the Isha daily prayer MUST be performed.

Exception Fields

Parameter	Description
error_code	Return error code `400` for any error occured.
error_type	Error types either REQUIRED_FIELD, INVALID_ZONE, LIMIT_EXCEEDED or COMPLEX_ERROR
error_desc	Show error description based on table below REQUIRED_FIELD Missing Required field. INVALID_ZONE Invalid zone code given. LIMIT_EXCEEDED Maximum limit of 365 queries exceeded. COMPLEX_ERROR Complex error has occured.

Example Request

https://api.azanpro.com/times/this_week.json?zone=sgr01&format=12-hour

Example Result

{
    "zone": "SGR01",
    "start": "27-09-2021",
    "end": "03-10-2021",
    "locations": [
        "Gombak",
        "Hulu Selangor",
        "Rawang",
        "Hulu Langat",
        "Sepang",
        "Petaling",
        "Shah Alam"
    ],
    "prayer_times": [
        {
            "date": "27-09-2021",
            "datestamp": 1632672000,
            "imsak": "5:44 am",
            "subuh": "5:54 am",
            "syuruk": "7:00 am",
            "zohor": "1:07 pm",
            "asar": "4:16 pm",
            "maghrib": "7:09 pm",
            "isyak": "8:18 pm"
        },
        {
            "date": "28-09-2021",
            "datestamp": 1632758400,
            "imsak": "5:44 am",
            "subuh": "5:54 am",
            "syuruk": "7:00 am",
            "zohor": "1:07 pm",
            "asar": "4:16 pm",
            "maghrib": "7:09 pm",
            "isyak": "8:17 pm"
        },
        {
            "date": "29-09-2021",
            "datestamp": 1632844800,
            "imsak": "5:44 am",
            "subuh": "5:54 am",
            "syuruk": "6:59 am",
            "zohor": "1:07 pm",
            "asar": "4:16 pm",
            "maghrib": "7:08 pm",
            "isyak": "8:17 pm"
        },
        {
            "date": "30-09-2021",
            "datestamp": 1632931200,
            "imsak": "5:44 am",
            "subuh": "5:54 am",
            "syuruk": "6:59 am",
            "zohor": "1:06 pm",
            "asar": "4:16 pm",
            "maghrib": "7:08 pm",
            "isyak": "8:17 pm"
        },
        {
            "date": "01-10-2021",
            "datestamp": 1633017600,
            "imsak": "5:43 am",
            "subuh": "5:53 am",
            "syuruk": "6:59 am",
            "zohor": "1:06 pm",
            "asar": "4:16 pm",
            "maghrib": "7:07 pm",
            "isyak": "8:16 pm"
        },
        {
            "date": "02-10-2021",
            "datestamp": 1633104000,
            "imsak": "5:43 am",
            "subuh": "5:53 am",
            "syuruk": "6:59 am",
            "zohor": "1:06 pm",
            "asar": "4:16 pm",
            "maghrib": "7:07 pm",
            "isyak": "8:16 pm"
        },
        {
            "date": "03-10-2021",
            "datestamp": 1633190400,
            "imsak": "5:43 am",
            "subuh": "5:53 am",
            "syuruk": "6:58 am",
            "zohor": "1:05 pm",
            "asar": "4:17 pm",
            "maghrib": "7:06 pm",
            "isyak": "8:15 pm"
        }
    ]
}