Agent tools · Last verified 2026-10-16

prayer times API for Claude & AI agents

Daily prayer times and Hijri calendar dates for any city or coordinates. Free REST API, no key.

What it does

AlAdhan is a free REST API run by Islamic Network. It returns daily prayer times (Fajr through Isha, plus Imsak and Midnight) and the matching Hijri date for a city or for latitude/longitude. You choose the calculation method, such as Muslim World League, ISNA or Umm al-Qura, so results can match a local mosque’s convention. Answers are compact JSON, which suits a quick agent tool call better than scraping a timetable page.

Verified facts

PriceFree. AlAdhan describes itself as offering a free REST API. [Verified 2026-10-16] source
API key / authNot required. Our test request ran without any key. [Verified 2026-10-16] source
Rate limit12 requests per second, per the ratelimit-limit and x-ratelimit-limit-second headers on our test request. [Verified 2026-10-16] source
TermsUse is subject to the credits, terms and conditions linked from aladhan.com. The service is operated by Mamluk LLC for Islamic Network. [Verified 2026-10-16] source
Calculation methodsPick a method with method=<id>. The full list is served by the Calculation Methods API. [Verified 2026-10-16] source
EndpointGET https://api.aladhan.com/v1/timingsByCity/{DD-MM-YYYY}?city=…&country=…&method=… [Verified 2026-10-16] source

Prompt to give your agent

When I ask for prayer times, call https://api.aladhan.com/v1/timingsByCity/<DD-MM-YYYY>?city=<city>&country=<country>&method=<id> (no API key). Ask me which calculation method my community uses if I haven't said. Show Fajr, Dhuhr, Asr, Maghrib and Isha in local time, plus the Hijri date, and mention that local mosque timetables can differ by a few minutes.

Agent / MCP-style tool snippet

// Agent tool definition (JSON Schema) — implement with HTTP GET
{
  "name": "aladhan_timings_by_city",
  "description": "Daily prayer times and Hijri date from AlAdhan. Free, no API key. Max 12 req/s.",
  "input_schema": {
    "type": "object",
    "properties": {
      "date": { "type": "string", "description": "DD-MM-YYYY" },
      "city": { "type": "string" },
      "country": { "type": "string" },
      "method": { "type": "integer", "description": "Calculation method id" }
    },
    "required": ["date", "city", "country"]
  }
}
// GET https://api.aladhan.com/v1/timingsByCity/{date}?city={city}&country={country}&method={method}

Working example (run 2026-10-16)

curl -sS "https://api.aladhan.com/v1/timingsByCity/16-10-2026?city=London&country=United%20Kingdom&method=15"

Response (trimmed):

HTTP 200; ratelimit-limit: 12; ratelimit-remaining: 11; ratelimit-reset: 1
{"code":200,"status":"OK","data":{"timings":{"Fajr":"05:50","Sunrise":"07:26","Dhuhr":"12:46",
  "Asr":"15:33","Maghrib":"18:05","Isha":"19:28", ...},
  "date":{"readable":"16 Oct 2026","hijri":{"date":"05-05-1448", ...}}}}

When not to use it

  • Do not override your local mosque’s published timetable. Calculated times can differ from the local convention by minutes.
  • Do not fetch one day at a time for a whole year. Use the monthly calendar endpoints and cache the results, and stay under 12 requests/second.
  • Do not leave out the method parameter in an app for a specific community. The default may not match their convention.

Use cases

  • Daily briefing agents and reminders
  • Travel assistants that adjust to the destination city
  • Calendar apps showing Hijri dates

FAQ

Does the AlAdhan API need a key?

No. Requests work without a key or account.

What is the AlAdhan rate limit?

Our test request returned a limit of 12 requests per second.

How do I match my mosque’s times?

Pass the method parameter for your community’s calculation convention. The Calculation Methods API lists them all.

Alternatives

Related