Religion: Bible & Quran

This API allows you to retrieve sacred texts from both the Bible and Quran.

• Bible: Supports multiple translations (KJV, WEB, BBE, etc.).
• Quran: Returns Arabic text, English translation, and recitation audio links.

Endpoint

POST /api/v1/religion

Request Parameters

The following parameters are accepted in the request body:

Field	Type	Required	Description
type	string	Yes	bible or quran.
reference	string	Yes	Format: “Book Chapter:Verse” (Bible) or “Surah:Ayah” (Quran).
version	string	Optional	Bible translation code. Default: web. Options: kjv, bbe, oeb-us, web.

Request Examples

cURL

curl -X POST https://heavstal.com.ng/api/v1/religion \
-H "Content-Type: application/json" \
-H "x-api-key: <YOUR_API_KEY>" \
-d '{"type": "bible", "reference": "John 3:16", "version": "kjv"}'

JavaScript (Fetch)

const response = await fetch('https://heavstal.com.ng/api/v1/religion', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': '<YOUR_API_KEY>'
  },
  body: JSON.stringify({
    type: 'bible',
    reference: 'John 3:16',
    version: 'kjv'
  })
});

const res = await response.json();
console.log(res.data.text);

Heavstal SDK

import { tools } from '@heavstal/api';

const verse = await tools.religion("bible", "John 3:16", "kjv");
console.log(verse.data.text);

Python

import requests

url = "https://heavstal.com.ng/api/v1/religion"
headers = {
    "Content-Type": "application/json",
    "x-api-key": "<YOUR_API_KEY>"
}
payload = {
    "type": "bible",
    "reference": "John 3:16",
    "version": "kjv"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json()["data"]["text"])

Response Examples

Success Response (Bible)

{
  "status": "success",
  "creator": "HEAVSTAL TECH",
  "data": {
    "type": "bible",
    "reference": "John 3:16",
    "text": "For God so loved the world...",
    "version": "King James Version",
    "version_id": "kjv"
  }
}

Error Response

{
  "status": "error",
  "error": "Invalid reference format provided."
}