Introduction

House Muslim exposes a public, read-only REST API powering prayer times, Qibla, the Hijri calendar, Ramadan, the Qur'an, dua, and daily content. Everything is computed locally by a self-hosted Islamic Time Engine — there are no third-party prayer APIs behind it.

Base URL

https://api.housemuslim.org/api/v1

All endpoints documented here are public (no authentication) unless noted.

Response envelope

Every response is wrapped in a consistent envelope:

{
  "success": true,
  "data": { "...": "..." },
  "meta": { "trace_id": "01c13f05-8cb2-4bd0-91ff-eac6665b3181" }
}

On error, success is false and an error object describes the problem (details lists the offending fields when relevant):

{
  "success": false,
  "error": {
    "code": "VALIDATION",
    "message": "lat harus antara -90 dan 90",
    "details": [{ "field": "lat", "rule": "range" }]
  },
  "meta": { "trace_id": "a964a54b-c36c-432e-9876-5fa9d48f5afc" }
}

Common status codes: 200 OK, 304 Not Modified (ETag), 422 validation, 429 rate limited.

curl "https://api.housemuslim.org/api/v1/prayer/times?lat=-6.20&lng=106.85"

What's available

Principles