Qibla Direction

Precise compass bearing to the Kaaba in Makkah using spherical trigonometry. Returns direction name, bearing in degrees, and distance in km and miles.

Calculate Qibla Direction

GET/api/v1/qibla

Returns the Qibla direction (compass bearing to the Kaaba) from any location on Earth.

---

Query Parameters

Parameter	Type	Description
lat*	float	Latitude of the location. Range: -90 to 90
lon*	float	Longitude of the location. Range: -180 to 180
api_key*	string	Your API key. Can also be sent via X-API-Key header.

---

Try Qibla API

Try Qibla API

Use your API key to send a live Qibla request from documentation.

Latitude *Latitude in decimal degrees.

Longitude *Longitude in decimal degrees.

API Key *Used as the api_key query parameter.

GET /api/v1/qibla?lat=LATITUDE&lon=LONGITUDE&api_key=YOUR_KEY

Example Request

curl "https://backend.muslimbd.app/api/v1/qibla?lat=24.7136&lon=46.6753&api_key=YOUR_KEY"

---

Example Response

{
  "status": 200,
  "ok": true,
  "url": "https://backend.muslimbd.app/api/v1/qibla?lat=24.7136&lon=46.6753&api_key=YOUR_KEY",
  "data": {
    "success": true,
    "service": "qibla",
    "data": {
      "qibla_direction": 243.8,
      "compass_bearing": "WSW",
      "location": {
        "latitude": 24.7136,
        "longitude": 46.6753
      },
      "kaaba_coordinates": {
        "latitude": 21.4225,
        "longitude": 39.8262
      },
      "distance_km": 790.31,
      "distance_miles": 491.08,
      "note": "Bearing is calculated as true north (geographic north), not magnetic north. Compass apps may show a different angle due to magnetic declination in your area."
    },
    "timestamp": "2026-05-21T13:03:54.466Z",
    "api_info": {
      "usage": "GET /api/v1/qibla?lat=LATITUDE&lon=LONGITUDE&apikey=YOUR_KEY"
    },
    "rateLimit": {
      "category": "calculation",
      "limit": 5,
      "remaining": 3,
      "nextResetAt": "2026-05-21T13:04:30.465Z"
    }
  }
}

---

Response Fields

Field	Type	Description
success	boolean	true when the request succeeded
service	string	Service identifier — always "qibla-direction"
data.qibla_direction	string	Cardinal/intercardinal direction (e.g. "Northwest")
data.compass_bearing	number	Bearing in degrees from North (0–360)
data.location	object	Input latitude and longitude
data.kaaba_coordinates	object	Fixed coordinates of the Kaaba
data.distance_km	number	Great-circle distance to Kaaba in kilometres
data.distance_miles	number	Great-circle distance to Kaaba in miles
data.note	string	Human-readable facing instruction
timestamp	string	ISO 8601 response timestamp
api_info.usage	string	Endpoint usage template
rateLimit.category	string	Rate limit category for the request
rateLimit.limit	number	Maximum requests allowed in the window
rateLimit.remaining	number	Requests remaining in the current window
rateLimit.nextResetAt	string	ISO 8601 time when the rate limit window resets

---

Error Responses

Missing or invalid coordinates — 400 Bad Request

{
  "success": false,
  "error": "Bad Request",
  "message": "lat and lon are required and must be valid numbers."
}

Invalid API key — 401 Unauthorized

{
  "success": false,
  "error": "Unauthorized",
  "message": "Invalid or missing API key."
}

---

Compass Direction Reference

Bearing Range	Direction
337.5° – 360° / 0° – 22.5°	North
22.5° – 67.5°	Northeast
67.5° – 112.5°	East
112.5° – 157.5°	Southeast
157.5° – 202.5°	South
202.5° – 247.5°	Southwest
247.5° – 292.5°	West
292.5° – 337.5°	Northwest ← most common for Middle East users