Prayer Times

Daily prayer times per regency/city.

Postman collectionOpenAPI spec

Base URL

https://use.api.co.id

Call GET /regional/indonesia/prayer-times with the x-api-co-id header and pass regency_code as a query parameter, optionally with a date range filter. The response contains prayer times with date information and GMT offset.

Prayer times

Each daily schedule includes: Imsyak, Shubuh, Terbit, Dhuha, Dzuhur, Ashr, Maghrib, and Isya.

Endpoints

Endpoint	Purpose
/regional/indonesia/prayer-times/regencies	List regencies that have prayer time data
/regional/indonesia/prayer-times	Prayer times by regency code, with an optional date range filter

Both endpoints support pagination with a fixed page size.

List Available Regencies

GET/regional/indonesia/prayer-times/regencies

Get all regencies that have prayer time data available.

Query parameters

Name	Type	Description
pageOptional	integer	Page number (optional, default: 1). Pagination size is fixed at 100 items per page. Example: 1

Response fields

Name	Type	Description
is_successOptional	boolean
messageOptional	string
dataOptional	object[]
data[].codeOptional	string	Regency code (4 digits) Example: 1101
data[].nameOptional	string	Regency name Example: KABUPATEN SIMEULUE
pagingOptional	object
paging.pageOptional	integer
paging.sizeOptional	integer
paging.total_itemOptional	integer
paging.total_pageOptional	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 parameters

Name	Type	Description
regency_codeRequired	string	Regency code (required, 4 digits, e.g., 3171 for Jakarta Selatan) Example: 3171
start_dateOptional	string	Start date filter (optional, format: YYYY-MM-DD). Only prayer times on or after this date are returned. Example: 2024-01-01
end_dateOptional	string	End date filter (optional, format: YYYY-MM-DD). Only prayer times on or before this date are returned. Example: 2024-01-31
pageOptional	integer	Page number (optional, default: 1). Pagination size is fixed at 100 items per page. Example: 1

Response fields

Name	Type	Description
is_successOptional	boolean
messageOptional	string
dataOptional	object[]
data[].idOptional	integer
data[].regency_codeOptional	string	Regency code (4 digits)
data[].regency_nameOptional	string	Regency name
data[].gmtOptional	integer	GMT offset
data[].dateOptional	string	Prayer time date in YYYY-MM-DD format
data[].yearOptional	integer
data[].monthOptional	integer
data[].dayOptional	integer
data[].imsyakOptional	string	Pre-dawn time (HH:MM format) Example: 04:30
data[].shubuhOptional	string	Dawn prayer / Fajr (HH:MM format) Example: 04:40
data[].terbitOptional	string	Sunrise (HH:MM format) Example: 05:55
data[].dhuhaOptional	string	Mid-morning prayer (HH:MM format) Example: 06:25
data[].dzuhurOptional	string	Noon prayer / Dhuhr (HH:MM format) Example: 12:05
data[].ashrOptional	string	Afternoon prayer / Asr (HH:MM format) Example: 15:20
data[].maghribOptional	string	Sunset prayer (HH:MM format) Example: 18:15
data[].isyaOptional	string	Night prayer (HH:MM format) Example: 19:30
pagingOptional	object
paging.pageOptional	integer
paging.sizeOptional	integer
paging.total_itemOptional	integer
paging.total_pageOptional	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  }}