Reference

Religion Engine

Overview

Heavstal Religion allows you to retrieve sacred texts from the Bible and Quran.

Bible: Returns verse text and reference (WEB/KJV versions).

Quran: Returns Arabic text, English translation (Sahih International), and a direct audio recitation link (Mishary Rashid Alafasy).

Endpoint

POST /religion

Request Parameters

Field	Type	Required	Description
type	string	Required	'bible' or 'quran'.
reference	string	Required	Format: "Book Chapter:Verse" (Bible) or "Surah:Ayah" (Quran).

Example 1: Bible

javascript

      const res = await fetch('https://heavstal-tech.vercel.app/api/v1/religion', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json', 'x-api-key': 'KEY' },
        body: JSON.stringify({ type: 'bible', reference: 'John 3:16' })
      });

Example 2: Quran (Ayatul Kursi)

javascript

      const res = await fetch('https://heavstal-tech.vercel.app/api/v1/religion', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json', 'x-api-key': 'KEY' },
        body: JSON.stringify({ type: 'quran', reference: '2:255' })
      });

Successful Response (Quran)

json

      {
        "status": "success",
        "creator": "HEAVSTAL TECH",
        "data": {
          "type": "quran",
          "reference": "Surah Al-Baqarah (2:255)",
          "arabic": "ٱللَّهُ لَآ إِلَٰهَ إِلَّا هُوَ ٱلْحَىُّ ٱلْقَيُّومُ...",
          "translation": "Allah - there is no deity except Him, the Ever-Living...",
          "audio": "https://cdn.alquran.cloud/media/audio/ayah/ar.alafasy/262"
        }
      }