Quick Start
bash
# Check API status
curlhttps://public.api.ihsandeen.com/api/status
# Get random Quran reflection
curlhttps://public.api.ihsandeen.com/api/quran/random
# Get random Seerah event
curlhttps://public.api.ihsandeen.com/api/events/random
# Get specific ayah (Surah 96, Ayah 1)
curlhttps://public.api.ihsandeen.com/api/quran/96/1
Endpoints
Status
Check API health
GET
/api/statusCheck if the API is running
Response: ApiStatus
| Field | Type | Description |
|---|---|---|
| status | string | Always 'ok' |
| service | string | Service name |
| timestamp | string | ISO timestamp |
GET
/apiGet API information and available endpoints
Response: ApiInfo
| Field | Type | Description |
|---|---|---|
| name | string | API name |
| description | string | API description |
| version | string | API version |
| endpoints | object | Available endpoints |
Quran Reflections
Detailed breakdown of Quranic verses
GET
/api/quran/randomGet a random Quran verse with reflection
Response: QuranReflection
| Field | Type | Description |
|---|---|---|
| surah_number | string | Surah number |
| surah_name | string | Surah name |
| ayah_number | string | Ayah number |
| ayah_arabic | string | Arabic text |
| ayah_translation | string | English translation |
| literary_devices | string[] | Literary devices used |
| primary_emotions | string[] | Emotions in the ayah |
| tone | string | Tone of the ayah |
| thematic_summary | string | Main theme |
GET
/api/quran/:surah/:ayahGet Quran verse by surah and ayah number
Parameters
surah—Surah number (1-114)*
ayah—Ayah number*
Response: QuranReflection
| Field | Type | Description |
|---|---|---|
| surah_number | string | Surah number |
| surah_name | string | Surah name |
| ayah_number | string | Ayah number |
| ayah_arabic | string | Arabic text |
| ayah_translation | string | English translation |
Seerah Events
Historical events from the life of Prophet Muhammad (ﷺ)
GET
/api/events/randomGet a random Seerah event with analysis
Response: EventData
| Field | Type | Description |
|---|---|---|
| event_id | string | Event ID (e.g., EVT-0001) |
| event_name | string | Name of the event |
| year_hijri | string | Year in Hijri/CE |
| location | string | Where it happened |
| phase | string | Phase of the Prophet's life |
| situation_context | string | Historical context |
| pressures_present | string[] | Challenges faced |
| decision_node | string | Key decision point |
| outcome | string | What happened |
| quranic_reference | object? | Related Quran verse |
| lessons_learned | string[]? | Key takeaways |
GET
/api/events/:idGet Seerah event by ID
Parameters
id—Event ID (e.g., "1" or "EVT-0001")*
Response: EventData
| Field | Type | Description |
|---|---|---|
| event_id | string | Event ID |
| event_name | string | Event name |
| year_hijri | string | Year |
| location | string | Location |
| phase | string | Phase |
Error Responses
| Status | Description | Response |
|---|---|---|
| 200 OK | Request successful | { } |
| 400 | Invalid parameters | { "error": "Invalid surah..." } |
| 404 | Resource not found | { "error": "Not found" } |
| 500 | Internal server error | { "error": "Internal Server Error" } |
99.99%
Uptime
< 50ms
Latency
10M+
Requests
5k+
Developers