Skip to content
All APIs

Indonesia · Worship · 1 endpoint

IDN Prayer Times

The five daily prayer times for any coordinates on earth, computed from solar position, with the Kemenag method as default.

Status
Operational
Price
1 credit / request
Rate limit
300 / 60s
Cache
None
Requests
0

Endpoint

How to call it

GET/v1/prayer-times/idn

Code

Request — cURL

v1

curl https://api.diraz.co.id/v1/prayer-times/idn \
  -H "Authorization: Bearer drz_live_…"

For AI agents

Callable through the MCP server with the same key:

call_api {"endpoint":"idn-prayer-times","params":{"lat":"-6.2088","lon":"106.8456","date":"2026-08-19"}}

Parameters

latnumber · required
Latitude, -90 to 90.
lonnumber · required
Longitude, -180 to 180.
datestring · optional
`YYYY-MM-DD`.Default: today
methodstring · optional
`kemenag`, `mwl`, `isna`, `egypt`, `karachi`, `umm-al-qura`, `dubai`, `singapore`. They differ in the sun's depression at Fajr and Isha.Default: kemenag
schoolstring · optional
`shafi` or `hanafi`. Hanafi Asr falls roughly an hour later.Default: shafi
timezonenumber · optional
UTC offset in hours.Default: 7
elevationnumber · optional
Metres above sea level.Default: 0

Example response

200 OK

JSON

{
  "data": {
    "date": "2026-08-19",
    "method": "Kementerian Agama Republik Indonesia",
    "school": "shafi",
    "coordinates": { "latitude": -6.2088, "longitude": 106.8456, "elevation": 0 },
    "timezone_offset": 7,
    "times": {
      "imsak": "04:30",
      "fajr": "04:40",
      "sunrise": "05:59",
      "dhuhr": "11:56",
      "asr": "15:17",
      "sunset": "17:54",
      "maghrib": "17:54",
      "isha": "19:05",
      "midnight": "23:56"
    },
    "warnings": []
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ"
  }
}
times
`imsak`, `fajr`, `sunrise`, `dhuhr`, `asr`, `sunset`, `maghrib`, `isha`, `midnight`, as `HH:MM` local.
warnings
Set at extreme latitudes, where the sun never reaches the required depression and a prayer time genuinely does not occur. Those read `--:--` rather than being invented.

Errors

When something goes wrong

Every failure carries a stable machine-readable code and the same meta.request_id a success carries — quote it and we can find your request. Errors are never billed.

401 Unauthorized

JSON

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "The API key is invalid, expired, or revoked."
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ"
  }
}
UNAUTHORIZEDHTTP 401
Missing, malformed, expired, or revoked API key.
FORBIDDENHTTP 403
The key is valid but lacks the scope this product needs.
VALIDATION_ERRORHTTP 422
A query parameter is the wrong type or out of range.
RATE_LIMITEDHTTP 429
Rate limit exhausted. `Retry-After` says how long to wait.
SERVICE_UNAVAILABLEHTTP 503
No data recent enough to serve. Carries `Retry-After`, and is never billed.

Health

Is it up?

  • IDN Prayer Times

1/1 passing