Prayer times

Documentation index for AI agents: /llms.txt. Every page is also available as markdown: add .md to the URL.

Daily and monthly prayer times for Indonesian regencies and cities.

Look up a city first with the city list endpoint, then request daily or monthly prayer times for it.

All endpoints need the x-api-key header (see Authentication) and return the standard envelope. A successful request costs 2 credits.

Endpoints on this page

GET /api/v1/sholat/list-kota: List available cities
GET /api/v1/sholat: Daily prayer times
GET /api/v1/sholat/monthly: Monthly prayer times

Prayer Times

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

GET /api/v1/sholat/list-kota

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

curl "https://use.apiindonesia.id/api/v1/sholat/list-kota" \
  -H "x-api-key: YOUR_API_KEY"

Example response (shortened):

{
  "data": [
    {
      "regency_id": "3273",
      "regency_name": "KOTA BANDUNG",
      "province_id": "32",
      "province_name": "JAWA BARAT"
    }
  ]
}

GET /api/v1/sholat

Daily prayer times. Returns one day of prayer times for a given regency/city.

Parameter	In	Required	Type	Description
`kabupaten_id`	query	yes	string	Regency/city code, e.g. 3273.
`tanggal`	query	no	string	Date in YYYY-MM-DD format. Defaults to today.

curl "https://use.apiindonesia.id/api/v1/sholat?kabupaten_id=3273" \
  -H "x-api-key: YOUR_API_KEY"

Example response (shortened):

{
  "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"
  }
}

GET /api/v1/sholat/monthly

Monthly prayer times. Returns a full month of prayer times for a given regency/city, sorted by date.

Parameter	In	Required	Type	Description
`kabupaten_id`	query	yes	string	Regency/city code, e.g. 3273.
`tahun`	query	yes	integer	Year, e.g. 2026.
`bulan`	query	yes	integer	Month (1–12), e.g. 7.

curl "https://use.apiindonesia.id/api/v1/sholat/monthly?kabupaten_id=3273&tahun=2026&bulan=7" \
  -H "x-api-key: YOUR_API_KEY"

Example response (shortened):

{
  "data": [
    {
      "id": "pt_3273_2026-07-01",
      "regency_id": "3273",
      "date": "2026-07-01",
      "imsyak": "04:28",
      "shubuh": "04:38",
      "terbit": "05:57",
      "dhuha": "06:25",
      "dzuhur": "11:55",
      "ashr": "15:17",
      "maghrib": "17:46",
      "isya": "19:00",
      "source": "Kemenag"
    }
  ]
}