# Prayer times

> Documentation index for AI agents: [/llms.txt](https://docs.apiindonesia.id/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](https://docs.apiindonesia.id/authentication.md)) and return the standard [envelope](https://docs.apiindonesia.id/errors.md). A successful request costs 2 credits.

## Endpoints on this page

- [`GET /api/v1/sholat/list-kota`](#get-api-v1-sholat-list-kota): List available cities
- [`GET /api/v1/sholat`](#get-api-v1-sholat): Daily prayer times
- [`GET /api/v1/sholat/monthly`](#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.

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

Example response (shortened):

```json
{
  "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. |

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

Example response (shortened):

```json
{
  "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. |

```bash
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):

```json
{
  "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"
    }
  ]
}
```