azanAPI

A stateless REST API for calculating Islamic prayer times from explicit location and calculation settings. It is designed for Home Assistant and general developer use.

Production API

The canonical public API base URL is:

https://api.aakashsharma.com.np

All public prayer endpoints are versioned under https://api.aakashsharma.com.np/api/v1/.

Project activity

GitHub stars: Loading… · Commits: Loading…

The API calculates Fajr, Sunrise, Dhuhr, Asr, Sunset, Maghrib, and Isha using coordinates, an IANA timezone, a local date, a calculation method, Madhab, and a high-latitude rule. It can also produce separately adjusted final Azan times without changing the underlying astronomical calculation.

Start here

• Get started
• API reference
• Core concepts
• Examples
• Home Assistant

Key design choices

• Explicit timezone: the API never guesses one from coordinates.
• Stable v1 contract: prayer endpoints are versioned under /api/v1/.
• Calculated versus Azan times: astronomical values are immutable; optional per-prayer offsets apply only to final Azan values.
• No database: every request contains the configuration needed to calculate its response.
• OpenAPI source of truth: /openapi.json and /docs define endpoint structure, while these guides explain how to use it.

Start with a first API request, then see the prayer-times endpoint for the full v1 contract.