{"info":{"_postman_id":"dd1e327e-19f3-4fcf-af57-e0feae51d996","name":"Prayer Time API","description":"

Complete API collection for Indonesian prayer times (jadwal sholat) by regency.

Features

List all available regencies with prayer time data
Get prayer times by regency code
Fixed pagination size (100 items per page)
Complete prayer schedule (Imsyak, Shubuh, Terbit, Dhuha, Dzuhur, Ashr, Maghrib, Isya)

Authentication

All requests require an API key in the x-api-co-id header.

Base URL

https://use.api.co.id/regional/indonesia/prayer-times\n

Data Structure

Regency Code: 4-digit code identifying the regency/kabupaten
Prayer Times: Daily prayer schedule with GMT offset
Date: Prayer time date in YYYY-MM-DD format

Prayer Times

Imsyak: Pre-dawn time
Shubuh: Dawn prayer (Fajr)
Terbit: Sunrise
Dhuha: Mid-morning prayer
Dzuhur: Noon prayer (Dhuhr)
Ashr: Afternoon prayer (Asr)
Maghrib: Sunset prayer
Isya: Night prayer

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"50289783","collectionId":"dd1e327e-19f3-4fcf-af57-e0feae51d996","publishedId":"2sB3dTuURv","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-12-16T10:19:23.000Z"},"item":[{"name":"Prayer Times","item":[{"name":"List Available Regencies","id":"f34724d8-d2c3-461c-8a94-ee80113e1440","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/prayer-times/regencies?page=1","description":"

Get all regencies that have prayer time data available.

Query Parameters

page (optional): Page number (default: 1)
Note: Pagination size is fixed at 100 items per page

Response Format

Returns a list of regencies with their codes and names.

Examples

# Get first page of available regencies\nGET /regional/indonesia/prayer-times/regencies\n\n# Get second page\nGET /regional/indonesia/prayer-times/regencies?page=2\n

Use Cases

Display dropdown of available regencies
Check which regencies have prayer time data
Navigate to specific regency for prayer times

\n","urlObject":{"path":["regional","indonesia","prayer-times","regencies"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Page number (optional, default: 1)

\n","type":"text/plain"},"key":"page","value":"1"}],"variable":[]}},"response":[{"id":"4a9edeea-685a-4a9a-a745-652844bbcc66","name":"Success - Available Regencies","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":{"raw":"https://use.api.co.id/regional/indonesia/prayer-times/regencies?page=1","host":["https://use.api.co.id"],"path":["regional","indonesia","prayer-times","regencies"],"query":[{"key":"page","value":"1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": [\n {\n \"code\": \"1101\",\n \"name\": \"KABUPATEN SIMEULUE\"\n },\n {\n \"code\": \"1102\",\n \"name\": \"KABUPATEN ACEH SINGKIL\"\n },\n {\n \"code\": \"1103\",\n \"name\": \"KABUPATEN ACEH SELATAN\"\n },\n {\n \"code\": \"3171\",\n \"name\": \"KOTA JAKARTA SELATAN\"\n },\n {\n \"code\": \"3172\",\n \"name\": \"KOTA JAKARTA TIMUR\"\n }\n ],\n \"paging\": {\n \"page\": 1,\n \"size\": 100,\n \"total_item\": 514,\n \"total_page\": 6\n }\n}"}],"_postman_id":"f34724d8-d2c3-461c-8a94-ee80113e1440"},{"name":"Get Prayer Times by Regency Code","id":"ace03c0b-0f45-44b9-a5b6-eeb6e024e505","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/prayer-times?regency_code=3171&start_date=2024-01-01&end_date=2024-01-31&page=1","description":"

Get prayer times for a specific regency code with optional date range filtering.

Query Parameters

regency_code (required): Regency code (4 digits, e.g., 3171 for Jakarta Selatan)
start_date (optional): Start date filter in YYYY-MM-DD format (e.g., 2024-01-01)
end_date (optional): End date filter in YYYY-MM-DD format (e.g., 2024-01-31)
page (optional): Page number (default: 1)
Note: Pagination size is fixed at 100 items per page

Response Format

Returns prayer times sorted by date (ascending). Each entry includes:

Date information (date, year, month, day)
GMT offset
All prayer times (Imsyak, Shubuh, Terbit, Dhuha, Dzuhur, Ashr, Maghrib, Isya)

Examples

# Get prayer times for Jakarta Selatan (code 3171)\nGET /regional/indonesia/prayer-times?regency_code=3171\n\n# Get prayer times for specific month\nGET /regional/indonesia/prayer-times?regency_code=3171&start_date=2024-01-01&end_date=2024-01-31\n\n# Get prayer times for specific date range\nGET /regional/indonesia/prayer-times?regency_code=3171&start_date=2024-01-01&end_date=2024-01-07\n\n# Get prayer times for Bandung (code 3273)\nGET /regional/indonesia/prayer-times?regency_code=3273\n\n# Get second page with date filter\nGET /regional/indonesia/prayer-times?regency_code=3171&start_date=2024-01-01&end_date=2024-01-31&page=2\n

Use Cases

Display daily prayer schedule
Build prayer time calendar for specific month
Get prayer times for date range
Calculate prayer times for specific dates
Integration with mobile apps

Date Filtering

If start_date is provided, only prayer times on or after this date are returned
If end_date is provided, only prayer times on or before this date are returned
Both parameters can be used together to filter a date range
Date format must be YYYY-MM-DD (e.g., 2024-01-01)

Error Responses

400 Bad Request: Missing or invalid regency_code parameter
404 Not Found: Regency code not found or no prayer time data available

\n","urlObject":{"path":["regional","indonesia","prayer-times"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Regency code (required, 4 digits, e.g., 3171 for Jakarta Selatan)

\n","type":"text/plain"},"key":"regency_code","value":"3171"},{"description":{"content":"

Start date filter (optional, format: YYYY-MM-DD)

\n","type":"text/plain"},"key":"start_date","value":"2024-01-01"},{"description":{"content":"

End date filter (optional, format: YYYY-MM-DD)

\n","type":"text/plain"},"key":"end_date","value":"2024-01-31"},{"description":{"content":"

Page number (optional, default: 1)

\n","type":"text/plain"},"key":"page","value":"1"}],"variable":[]}},"response":[{"id":"4cb83c14-98d3-44af-a282-c0418c3d8e93","name":"Success - Prayer Times","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":{"raw":"https://use.api.co.id/regional/indonesia/prayer-times?regency_code=3171&start_date=2024-01-01&end_date=2024-01-31&page=1","host":["https://use.api.co.id"],"path":["regional","indonesia","prayer-times"],"query":[{"key":"regency_code","value":"3171"},{"key":"start_date","value":"2024-01-01"},{"key":"end_date","value":"2024-01-31"},{"key":"page","value":"1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": [\n {\n \"id\": 1,\n \"regency_code\": \"3171\",\n \"regency_name\": \"KOTA JAKARTA SELATAN\",\n \"gmt\": 7,\n \"date\": \"2024-01-01\",\n \"year\": 2024,\n \"month\": 1,\n \"day\": 1,\n \"imsyak\": \"04:30\",\n \"shubuh\": \"04:40\",\n \"terbit\": \"05:55\",\n \"dhuha\": \"06:25\",\n \"dzuhur\": \"12:05\",\n \"ashr\": \"15:20\",\n \"maghrib\": \"18:15\",\n \"isya\": \"19:30\"\n },\n {\n \"id\": 2,\n \"regency_code\": \"3171\",\n \"regency_name\": \"KOTA JAKARTA SELATAN\",\n \"gmt\": 7,\n \"date\": \"2024-01-02\",\n \"year\": 2024,\n \"month\": 1,\n \"day\": 2,\n \"imsyak\": \"04:30\",\n \"shubuh\": \"04:40\",\n \"terbit\": \"05:56\",\n \"dhuha\": \"06:26\",\n \"dzuhur\": \"12:05\",\n \"ashr\": \"15:20\",\n \"maghrib\": \"18:15\",\n \"isya\": \"19:30\"\n },\n {\n \"id\": 3,\n \"regency_code\": \"3171\",\n \"regency_name\": \"KOTA JAKARTA SELATAN\",\n \"gmt\": 7,\n \"date\": \"2024-01-03\",\n \"year\": 2024,\n \"month\": 1,\n \"day\": 3,\n \"imsyak\": \"04:31\",\n \"shubuh\": \"04:41\",\n \"terbit\": \"05:56\",\n \"dhuha\": \"06:26\",\n \"dzuhur\": \"12:06\",\n \"ashr\": \"15:21\",\n \"maghrib\": \"18:16\",\n \"isya\": \"19:31\"\n }\n ],\n \"paging\": {\n \"page\": 1,\n \"size\": 100,\n \"total_item\": 366,\n \"total_page\": 4\n }\n}"},{"id":"8ab4c5db-6c89-4054-b9d6-0534591e6447","name":"Error - Missing Regency Code","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/prayer-times"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"regency_code query parameter is required\",\n \"data\": null\n}"},{"id":"999ffc82-2080-4077-9127-419f37294f4d","name":"Error - Invalid API Key","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"invalid_key","type":"text"}],"url":{"raw":"https://use.api.co.id/regional/indonesia/prayer-times?regency_code=3171","host":["https://use.api.co.id"],"path":["regional","indonesia","prayer-times"],"query":[{"key":"regency_code","value":"3171"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"Invalid API key\",\n \"data\": null\n}"}],"_postman_id":"ace03c0b-0f45-44b9-a5b6-eeb6e024e505"}],"id":"c3014283-3777-4531-918f-b993d275caef","description":"

Endpoints for accessing Indonesian prayer times by regency.

\n","_postman_id":"c3014283-3777-4531-918f-b993d275caef"}],"variable":[{"key":"base_url","value":"https://use.api.co.id","type":"string","description":"Base URL for the API"},{"key":"api_key","value":"YOUR_API_KEY_HERE","type":"string","description":"Your API key for authentication. Get it from api.dashboard or your database."}]}