Skip to content

Developers

Prayer times, by API and MCP

The calculation engine of the Minare apps: prayer times anywhere on Earth, monthly timetables, the qibla and the Hijri date. Diyanet is the default method in Turkey.

Every page on this website is public and free. The API and the MCP server are for bringing the times into your own app or assistant, and they need a key.

Plans

Trial

For trying it out and small projects. No card needed.

Free

  • 10 requests per minute
  • 1,000 requests per month
  • The whole JSON API
  • The MCP server
  • Every calculation method
Get a key

Pro

For apps, websites and bots.

$9/month

  • 60 requests per minute
  • 100,000 requests per month
  • The whole JSON API
  • The MCP server
  • Every calculation method
Get a key

Business

For high traffic and organisations.

$49/month

  • 300 requests per minute
  • 1,000,000 requests per month
  • The whole JSON API
  • The MCP server
  • Every calculation method
Get a key

Limits belong to your account's plan; API and MCP requests count against the same quota. Paid plans are billed monthly through Polar and can be cancelled from the dashboard at any time.

Getting a key

  1. 1Sign in with Apple, Google or your email. There is no password, and your Minare Qur'an account works here too.
  2. 2Create a key in the developer dashboard. It is shown only once; we keep only a hash of it.
  3. 3Add the key to your requests. You start on the Trial plan; upgrade from the dashboard when you need more.
Get a key

Authentication

Send your key with every request: Authorization: Bearer mk_… or X-API-Key: mk_…. Requests without a valid key get a 401, revoked keys a 403; the body links to this page.

Example

curl https://minare.app/api/v1/times?city=istanbul \
    -H "Authorization: Bearer mk_…"

Endpoints

  • GET /api/v1/times?city=Kadıköy

    One day: Imsak, Fajr, sunrise, Dhuhr, Asr, Maghrib, Isha and extra times

  • GET /api/v1/month?city=london&year=2027&month=2

    A month's timetable

  • GET /api/v1/next?lat=41.01&lon=28.98

    The next prayer and the seconds left

  • GET /api/v1/qibla?city=berlin

    Qibla bearing and distance to the Kaaba

  • GET /api/v1/cities?q=ist

    Search cities and districts

  • GET /api/v1/hijri?date=2027-02-08

    Hijri date

Common parameters

city
City name (Kadıköy, London) or a minare.app path (turkey/istanbul/kadikoy)
lat, lon, tz
Coordinates instead of a city; add tz for the time zone
date
YYYY-MM-DD; local today when omitted
method
Calculation method; chosen by country when omitted
madhab
shafi or hanafi; chosen by country when omitted

Limits

Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for the per-minute limit, and X-Quota-Limit, X-Quota-Remaining and X-Quota-Reset for the monthly quota. Over the limit you get a 429 with Retry-After.

Documentation