Calendar & time Islamic Network (AlAdhan)
AlAdhan Prayer Times API
Look up prayer schedules and Hijri dates for a location using ordinary HTTP requests.
Source review: 2026-10-16 · Imported: 1 November 2026
A practical starting point
What could you build?
Build a personal calendar helper that displays the next prayer time for a selected city.
Before you connect
Choose the appropriate calculation method and timezone. Local conventions can produce different times.
Capabilities & requirements
Dated specifications from the licensed source dataset. “Not published” indicates missing information, rather than confirmed absence.
| Capability | Details and source |
|---|---|
| Status | Not published No GA/beta label on the API or terms pages. Source (external) · Not published by vendor: checked 2026-10-17 on https://aladhan.com/prayer-times-api |
| API key required | No key Test request returned HTTP 200 without a key. Source (external) · Verified 2026-10-17 by test request to https://api.aladhan.com/v1/timingsByCity/17-10-2026?city=London&country=United%20Kingdom&method=15 |
| Free tier | Free Described as a free REST API. Source (external) · Verified 2026-10-17 on https://aladhan.com/prayer-times-api |
| Rate limit | 12 requests/s ratelimit-limit and x-ratelimit-limit-second headers on the source publisher’s test request. Source (external) · Verified 2026-10-17 by test request to https://api.aladhan.com/v1/timingsByCity/17-10-2026?city=London&country=United%20Kingdom&method=15 |
| Official MCP server | Not published No official MCP server is listed on the developer pages. Source (external) · Not published by vendor: checked 2026-10-17 on https://aladhan.com/clients-api |
| Official SDK | PHP, JavaScript Two official SDKs listed on the API Clients page. Source (external) · Verified 2026-10-17 on https://aladhan.com/clients-api |
| Data license / terms | Not published No data license is published; the terms provide the API as-is, without warranty. Source (external) · Not published by vendor: checked 2026-10-17 on https://aladhan.com/credits-and-terms |
| Commercial use allowed | Not published The terms do not address commercial use. Source (external) · Not published by vendor: checked 2026-10-17 on https://aladhan.com/credits-and-terms |
| CORS / browser use | Access-Control-Allow-Origin: * Returned on a GET with a third-party Origin header. Source (external) · Verified 2026-10-17 by test request to https://api.aladhan.com/v1/timingsByCity/17-10-2026?city=London&country=United%20Kingdom&method=15 |
| Freshness / coverage | Computed per request; any location Any city or coordinates. Times are calculated with the Pray Times formulas. Source (external) · Verified 2026-10-17 on https://aladhan.com/credits-and-terms |
Operational reference
Additional facts and qualifications retained from AgentAPIList’s CC BY 4.0 dataset, with provider references.
API key / auth
Not required. The source publisher’s test request ran without any key.
Provider reference (external)Rate limit
12 requests per second, per the ratelimit-limit and x-ratelimit-limit-second headers on the source publisher’s test request.
Provider reference (external)Terms
Use is subject to the credits, terms and conditions linked from aladhan.com. The service is operated by Mamluk LLC for Islamic Network.
Provider reference (external)Calculation methods
Pick a method with method=<id>. The full list is served by the Calculation Methods API.
Provider reference (external)Endpoint
GET https://api.aladhan.com/v1/timingsByCity/{DD-MM-YYYY}?city=…&country=…&method=…
Provider reference (external)Setup references
HTTP request example
Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.
curl -sS "https://api.aladhan.com/v1/timingsByCity/16-10-2026?city=London&country=United%20Kingdom&method=15"Agent connection example
Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.
// 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}A tool schema needs an HTTP implementation; it does not by itself install an MCP server. Keep credentials out of browser code.
Other connections to explore
Back to the full directory →Source & reuse
Download the complete licensed source snapshot (JSON), including the original source’s caveats, alternative notes and examples.