Welcome to Al Adhan Python API’s documentation!

This Python module calculates accurate Islamic prayer times for any location. It uses the aladhan.com prayer times API and converts the API responses into Python objects. No API key or registration is required. This module simplifies the process of using the aladhan.com prayer times API in Python projects.

Note

This module is still in development and under alpha version, so it may have some bugs, and the API may have major changes in the future.

Table of contents:

• Installation
• Choosing a location
  • aladhan.Coordinates
  • aladhan.City
  • aladhan.Address
• Client Class
  • aladhan.Client
  • aladhan.Client.get_today_times
  • aladhan.Client.get_calendar_times
  • aladhan.Client.get_annual_times
  • aladhan.Client.api_status
  • Table of today’s prayer times example
• Adhan Object
  • aladhan.Adhan.readable_timing
  • aladhan.Adhan.wait
  • aladhan.Adhan.is_passed
  • aladhan.Adhan.is_hijri
  • aladhan.Adhan.is_secret
  • aladhan.Adhan.rakat
  • aladhan.Adhan.get_en_name
  • aladhan.Adhan.get_ar_name
  • aladhan.Adhan.sunnan_al_rawatib
• Exception Handling
  • aladhan.BadRequestException
  • aladhan.RateLimitedException
  • aladhan.ServerErrorException
  • aladhan.InvalidLocationException