Prayer Times İmsakiyem API Documentation

v1.0.1 | Last updated: January 3, 2026

Language / Dil: 🇹🇷 Türkçe | 🇬🇧 English

Prayer Times İmsakiyem API is a free API service that provides daily, weekly, monthly, and yearly prayer times for countries worldwide, published by the Presidency of Religious Affairs of Türkiye.

Key Features:
✅ Hierarchical Country/City/District data access
✅ Dynamic time range options for prayer times

Quick Start

# List districts of Ankara
curl -X GET "https://ezanvakti.imsakiyem.com/api/locations/districts?stateId=506" \
-H "Accept: application/json"

# List yearly prayer times for Ankara/Polatlı district (ID:9220)
curl -X GET "https://ezanvakti.imsakiyem.com/api/prayer-times/9220/yearly" \
-H "Accept: application/json"

• Istanbul SultanBeyli Daily Prayer Times
• Tekirdağ Çorlu Weekly Prayer Times
• Ankara Polatlı Monthly Prayer Times
• Muş Bulanık Yearly Prayer Times
• Germany Hamburg WILHELMSBURG Prayer Times from March 14 (2026-03-14) to June 6 (2026-06-06)

📋 Updates

January 3, 2026:

• ✅ 2026 prayer times data added
• 📦 For open data set, see open-data/prayer-times/README.md
• 🔧 Data corrections:
  • Incorrectly named data has been corrected
  • Incorrect country display has been fixed to "FILISTIN" (Palestine)
  • Cities that were incorrectly named with "israel" have been updated to correct names:
    • Ashdod → Isdud
    • Beersheba → Birü's-Seb
    • Haifa → Hefa
    • Nazareth → En-Nasira
    • Netanya → Umm Khalid
    • Rishon LeZion → Uyun Karah
    • Tel Aviv → Yafa

API Endpoints

🌍 Geographic Location Data

Countries

Parameters:

• countryId (Path, Required)
• q (Query, Optional)

Example Usage:

GET /api/locations/countries/2 HTTP/1.1
Host: ezanvakti.imsakiyem.com

States

Parameters:

• countryId (Query, Required)
• stateId (Path, Required)
• q (Query, Optional)

Districts

Parameters:

• stateId (Query, Required)
• districtId (Path, Required)
• q (Query, Optional)

🕋 Prayer Times

GET /api/prayer-times/{districtId}/{period} HTTP/1.1

Parameters:

Example Request:

curl -X GET "https://ezanvakti.imsakiyem.com/api/prayer-times/9147/monthly?startDate=2025-02-15" \
-H "Accept: application/json"

Note: monthly and yearly return the month and year within the specified time range. (e.g., requesting monthly data for March 16 will return data for March 1-31)

⚠️ Usage Limitations

• Rate Limit: 100 requests / 5 minutes
• Supported Format: application/json

Logging Policy

Important Notes:

• All IP addresses are anonymized in compliance with GDPR
• Performance metrics are used for server optimization
• Logs are automatically deleted after 14 days

❌ Error Handling

API Documentation Resources

Swagger Documentation
Swagger JSON Documentation
Postman Collection
Open Data Set - JSON format prayer times data for Türkiye and KKTC (v1.0.0 Release)

📝 License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0). You may use, modify, and distribute this software. However:

• You must share the source code
• You must document changes
• You must use the same license
• See LICENSE file for details.

Contact

You can contact us through the following channels for errors, suggestions, requests, and complaints.

Note: All dates must be in ISO 8601 (YYYY-MM-DD) format. Regional data requires hierarchical access:

• Country → State → District → Prayer Times

Planned Features

1. Geographic Coordinate Support

• Latitude/Longitude based location queries
• Precise geographic region detection
• Latitude/Longitude based prayer times data

2. Multi-language Response

• Language parameter (lang=tr/en) support
• Fully separated English/Turkish field names

3. Ramadan and special times integration
4. Sun, moon and qibla data
5. Real-time notifications via WebSocket
6. Mobile SDKs (Android/iOS)
7. Prayer times data by calculation methods