Skip to content
Minare
EN
Minare

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 a passkey or create an account with 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

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