REST API v1.0

Developer API & Docs

Integrate authentic Islamic artificial intelligence reasoning, Quran recitation streams, Sihah Sittah Hadith lookup, and mathematical worship utilities directly into your applications.

OpenAPI 3.1 Spec Live Test Console

1. Overview & Base URL

The Rhenuma AI REST API adheres to strict architectural standards, delivering structured JSON payloads with sub-second inference speeds backed by Groq LPU hardware.

Production Base URL: https://rhenuma.com/api/v1

2. Authentication

Public requests do not require an API key and are subject to standard rate limits. To unlock higher throughput (120 - 300 req/min), provide an API key using the X-API-Key header or standard Authorization: Bearer <KEY>.

Authorization: Bearer rhenuma_live_sec_****************

3. Rate Limiting & HTTP Headers

Rate limits are evaluated across a sliding 60-second window. Every response includes standard rate telemetry headers:

Header Name Description Example
X-RateLimit-Limit Maximum requests permitted per minute window 30 (Anonymous) / 120 (Auth)
X-RateLimit-Remaining Remaining request quota in active window 28
X-RateLimit-Reset Seconds remaining until the quota resets 45
HTTP 429 Too Many Requests: When rate limits are exceeded, the API returns a 429 status code with a Retry-After header specifying the required waiting duration in seconds.
POST

/api/v1/chat

Execute natural language inquiries under classical theological guardrails (Quran, Sihah Sittah, 4 Madhhabs). Automatically detects Quranic citations and parses interactive audio streams. Features built-in automatic failover rotation across all high-performance models if capacity is constrained.

Supported AI Models (Auto-Rotated on Rate Limits)
llama-3.3-70b-versatile
Flagship Reasoner
deepseek-r1-distill-llama-70b
Juristic Logic & Proofs
qwen-2.5-32b
Arabic Specialist
llama-3.1-8b-instant
Ultra-Fast Latency
gemma2-9b-it
Concise Structuring
mixtral-8x7b-32768
32k Extended Context
curl -X POST "https://rhenuma.com/api/v1/chat" \
     -H "Content-Type: application/json" \
     -d '{
       "prompt": "What are the virtues of Surah Al-Mulk before sleeping?",
       "model": "llama-3.3-70b-versatile",
       "max_tokens": 2048,
       "temperature": 0.6
     }'
GET

/api/v1/quran

Fetch complete Surahs, specific Ayats with translations, or perform semantic text search with Mishary Alafasy audio streams.

# 1. Fetch Surah Al-Ikhlas (Chapter 112)
curl -X GET "https://rhenuma.com/api/v1/quran?surah=112"

# 2. Fetch Ayat al-Kursi (Surah 2, Verse 255)
curl -X GET "https://rhenuma.com/api/v1/quran?surah=2&ayah=255"

# 3. Search verses containing "patience"
curl -X GET "https://rhenuma.com/api/v1/quran?search=patience"
GET

/api/v1/hadith

Search authentic narrations across the classical Sihah Sittah collections.

# Search Hadiths on 'intentions' from Sahih al-Bukhari
curl -X GET "https://rhenuma.com/api/v1/hadith?collection=bukhari&search=intentions"
GET

/api/v1/duas

Access authentic Hisnul Muslim supplications with Arabic, transliteration, and Hadith grades.

# Fetch Morning & Evening supplications
curl -X GET "https://rhenuma.com/api/v1/duas?category=Morning%20%26%20Evening"
POST

/api/v1/utilities

Perform mathematical calculations for 2.5% Zakat, Qibla heading degrees, and astronomical prayer times.

# Calculate Zakat obligation
curl -X POST "https://rhenuma.com/api/v1/utilities" \
     -H "Content-Type: application/json" \
     -d '{
       "action": "zakat",
       "cash": 10000,
       "gold": 3000,
       "debt": 1500,
       "gold_price_per_gram": 75
     }'
Interactive Test Bench

Live API Playground

// Click "Execute Live API Request" to test this endpoint...