Jadwal Sholat

Jadwal sholat harian per kabupaten/kota.

Koleksi PostmanOpenAPI spec

Base URL

https://use.api.co.id

Panggil GET /regional/indonesia/prayer-times dengan header x-api-co-id dan kirim regency_code sebagai query parameter, opsional dengan filter rentang tanggal. Response berisi jadwal sholat beserta informasi tanggal dan offset GMT.

Waktu sholat

Setiap jadwal harian memuat: Imsyak, Shubuh, Terbit, Dhuha, Dzuhur, Ashr, Maghrib, dan Isya.

Endpoint

Endpoint	Fungsi
/regional/indonesia/prayer-times/regencies	Daftar kabupaten/kota yang punya data jadwal sholat
/regional/indonesia/prayer-times	Jadwal sholat berdasarkan kode kabupaten/kota, dengan filter rentang tanggal opsional

Kedua endpoint mendukung pagination dengan ukuran halaman tetap.

List Available Regencies

GET/regional/indonesia/prayer-times/regencies

Get all regencies that have prayer time data available.

Query parameter

Nama	Tipe	Keterangan
pageOpsional	integer	Page number (optional, default: 1). Pagination size is fixed at 100 items per page. Contoh: 1

Field response

Nama	Tipe	Keterangan
is_successOpsional	boolean
messageOpsional	string
dataOpsional	object[]
data[].codeOpsional	string	Regency code (4 digits) Contoh: 1101
data[].nameOpsional	string	Regency name Contoh: KABUPATEN SIMEULUE
pagingOpsional	object
paging.pageOpsional	integer
paging.sizeOpsional	integer
paging.total_itemOpsional	integer
paging.total_pageOpsional	integer

Request

curl -X GET "https://use.api.co.id/regional/indonesia/prayer-times/regencies" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccess - Available Regencies

{  "is_success": true,  "message": "Success",  "data": [    {      "code": "1101",      "name": "KABUPATEN SIMEULUE"    },    {      "code": "1102",      "name": "KABUPATEN ACEH SINGKIL"    },    {      "code": "1103",      "name": "KABUPATEN ACEH SELATAN"    },    {      "code": "3171",      "name": "KOTA JAKARTA SELATAN"    },    {      "code": "3172",      "name": "KOTA JAKARTA TIMUR"    }  ],  "paging": {    "page": 1,    "size": 100,    "total_item": 514,    "total_page": 6  }}

Get Prayer Times by Regency Code

GET/regional/indonesia/prayer-times

Get prayer times for a specific regency code with optional date range filtering. Returns prayer times sorted by date (ascending). Each entry includes date information, GMT offset, and all prayer times (Imsyak, Shubuh, Terbit, Dhuha, Dzuhur, Ashr, Maghrib, Isya).

Query parameter

Nama	Tipe	Keterangan
regency_codeWajib	string	Regency code (required, 4 digits, e.g., 3171 for Jakarta Selatan) Contoh: 3171
start_dateOpsional	string	Start date filter (optional, format: YYYY-MM-DD). Only prayer times on or after this date are returned. Contoh: 2024-01-01
end_dateOpsional	string	End date filter (optional, format: YYYY-MM-DD). Only prayer times on or before this date are returned. Contoh: 2024-01-31
pageOpsional	integer	Page number (optional, default: 1). Pagination size is fixed at 100 items per page. Contoh: 1

Field response

Nama	Tipe	Keterangan
is_successOpsional	boolean
messageOpsional	string
dataOpsional	object[]
data[].idOpsional	integer
data[].regency_codeOpsional	string	Regency code (4 digits)
data[].regency_nameOpsional	string	Regency name
data[].gmtOpsional	integer	GMT offset
data[].dateOpsional	string	Prayer time date in YYYY-MM-DD format
data[].yearOpsional	integer
data[].monthOpsional	integer
data[].dayOpsional	integer
data[].imsyakOpsional	string	Pre-dawn time (HH:MM format) Contoh: 04:30
data[].shubuhOpsional	string	Dawn prayer / Fajr (HH:MM format) Contoh: 04:40
data[].terbitOpsional	string	Sunrise (HH:MM format) Contoh: 05:55
data[].dhuhaOpsional	string	Mid-morning prayer (HH:MM format) Contoh: 06:25
data[].dzuhurOpsional	string	Noon prayer / Dhuhr (HH:MM format) Contoh: 12:05
data[].ashrOpsional	string	Afternoon prayer / Asr (HH:MM format) Contoh: 15:20
data[].maghribOpsional	string	Sunset prayer (HH:MM format) Contoh: 18:15
data[].isyaOpsional	string	Night prayer (HH:MM format) Contoh: 19:30
pagingOpsional	object
paging.pageOpsional	integer
paging.sizeOpsional	integer
paging.total_itemOpsional	integer
paging.total_pageOpsional	integer

Request

curl -X GET "https://use.api.co.id/regional/indonesia/prayer-times?regency_code=3171" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccess - Prayer Times

{  "is_success": true,  "message": "Success",  "data": [    {      "id": 1,      "regency_code": "3171",      "regency_name": "KOTA JAKARTA SELATAN",      "gmt": 7,      "date": "2024-01-01",      "year": 2024,      "month": 1,      "day": 1,      "imsyak": "04:30",      "shubuh": "04:40",      "terbit": "05:55",      "dhuha": "06:25",      "dzuhur": "12:05",      "ashr": "15:20",      "maghrib": "18:15",      "isya": "19:30"    },    {      "id": 2,      "regency_code": "3171",      "regency_name": "KOTA JAKARTA SELATAN",      "gmt": 7,      "date": "2024-01-02",      "year": 2024,      "month": 1,      "day": 2,      "imsyak": "04:30",      "shubuh": "04:40",      "terbit": "05:56",      "dhuha": "06:26",      "dzuhur": "12:05",      "ashr": "15:20",      "maghrib": "18:15",      "isya": "19:30"    },    {      "id": 3,      "regency_code": "3171",      "regency_name": "KOTA JAKARTA SELATAN",      "gmt": 7,      "date": "2024-01-03",      "year": 2024,      "month": 1,      "day": 3,      "imsyak": "04:31",      "shubuh": "04:41",      "terbit": "05:56",      "dhuha": "06:26",      "dzuhur": "12:06",      "ashr": "15:21",      "maghrib": "18:16",      "isya": "19:31"    }  ],  "paging": {    "page": 1,    "size": 100,    "total_item": 366,    "total_page": 4  }}