API Reference

Prayer Times

The Prayer Times API returns imsyak, subuh, sunrise, dhuha, dzuhur, ashar, maghrib and isya times for 514 Indonesian regencies/cities, sourced from equran.id and aladhan.com. Fetch one day or a full month using the same regency/city code as the Regions API.

Main endpoint
GET https://use.apiindonesia.id/api/v1/sholat/list-kota
Endpoints
3
Authentication
x-api-key header (create one free in the dashboard)
Price
2 credits (Rp2) per successful request; failed requests are free
Format
JSON (REST), with cURL, JavaScript and Python examples
Product Brief

What this API gives you

Daily and monthly prayer times for 514 regencies/cities across Indonesia. Data is sourced from equran.id and aladhan.com.

Coverage
3

ready-to-use endpoints in this product, with JSON responses and consistent error handling.

Access
API key

Can be tried with the 3,000 credit signup bonus, then used in production through one API Indonesia key.

Sample resource
https://use.apiindonesia.id/api/v1/sholat/list-kota

Returns the regencies/cities that have prayer time data. Use the regency_id from this response with the schedule endpoints.

When should you use it?

The Prayer Times API fits Muslim apps, Islamic media, mosque displays, and community products that need daily or monthly prayer times by Indonesian regency/city.

Users choose their city, then the app shows a stable prayer schedule.

Content or notifications need to follow Fajr, Dhuhr, Asr, Maghrib, and Isha times.

The product needs Kemenag-sourced data without storing per-city schedule files.

Use the regency/city code from the user’s selected location. For precise GPS flows, you still need to map coordinates to the nearest regency/city.

Example product scenarios

This section separates the product page from the docs. The docs explain how to call endpoints; this page explains why the endpoints make sense for your feature.

  • Muslim lifestyle apps: show accurate prayer times based on the user's location.
  • Mosques & dakwah organizations: auto-sync adhan schedules on digital announcement boards.
  • Ed-tech & Islamic content platforms: embed prayer times into learning apps or media products.

Example Usage

Request
curl "https://use.apiindonesia.id/api/v1/sholat?kabupaten_id=3273&tanggal=2026-07-03" \
  -H "x-api-key: YOUR_API_KEY"
Response · 200 OK
{
  "data": {
    "id": "pt_3273_2026-07-03",
    "regency_id": "3273",
    "date": "2026-07-03",
    "imsyak": "04:29",
    "shubuh": "04:39",
    "terbit": "05:58",
    "dhuha": "06:26",
    "dzuhur": "11:56",
    "ashr": "15:17",
    "maghrib": "17:47",
    "isya": "19:01",
    "source": "Kemenag"
  }
}

Browse the data

Related Articles

Pricing 2 credits (Rp2) per successful request; failed requests are free. One-time 3,000 credit signup bonus, no credit card, no monthly allowance.

Prayer Times API questions

Which cities have prayer times?

Prayer times cover 514 regencies/cities. GET /api/v1/sholat/list-kota returns the full list with the regency_id used by the schedule endpoints.

How do I get a full month, for example for an imsakiyah schedule?

Use GET /api/v1/sholat/monthly?kabupaten_id=3273&tahun=2026&bulan=3. Each day includes imsyak, subuh, sunrise, dhuha, dzuhur, ashar, maghrib and isya.

Where do the times come from?

Times are sourced from the Ministry of Religious Affairs (Kemenag). The regency/city code matches the Regions API, so you can use it straight from a user address.

Get Started

Start Integrating
Today

Sign up for free and get a 3,000 credit bonus (Rp3,000) once your email is verified, grab an API key, and call your first endpoint right away. No credit card, no tedious approval process.

Dot wave visualization